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هو تطبيق مهمته استقبال طلبات مصدرها تطبيقات أخرى تدعى متصفحات الوب (أو زبون الوب)ء وتقديم خدمة إرسال صفحات 
ا11 مطلوبة من قبل هذه المتصفحات. يتم التواصل بين الزبون والمخدم اعتماداً على البروتوكول التطبيقي 1۲۲۲. 


النصوص البرمجية من جهة المخدم 
تعریف: 
تبر النصوص البرمجية من جهة المخدم إحدى تقنيات مخدمات صفحات الوب والتي يتم فيها الاستجابة لطلب المستخدم والتفاعل معه»› 


عبر تشغيل نص برمجي على المخدم وتوليد صفحات ۲۷1[ ديناميكية. 


تخت الوص البرسية من جهة المحم عادة لكامين تخديم مواقم الأنترنت التفاعلية التي تشكل واجهة تعامل مع قواعد بيانات أو أي 
إمصدر آخر للبيانات. 


تم تمييز هذه التقنية بعبارة (من جهة المخدم) بسبب وجود تقنيات أخرى تكون فيها مسؤولية تنفيذ النصوص البرمجية على عاتق متصفح 
صفحات الوب (التطبيق الزبون)» وتسمى التقنية باسم النصوص البرمجية من جهة الزبون. 
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جهة المخدم أم جهة الزبون؟ (1) 


OF E 
ڪڪ‎ 


لتوضيح فكرة النصوص البرمجية من جهة المخدم أو من جهة الزبون سنستعين بتمثيل بسيط لعلاقة مخدم الوب مع تطبيق زبون 
(المتصفح في حالتنا). 

يمر التفاعل بين الزبون ومخدم الوب بالمراحل التالية: 

1 يرسل التصفح (التطبيق الزبون) إلى المخدم طلب 1١۴‏ عبر الشبكةء بهدف استعراض صفحة معينة باستخدام محدد 


يستلم المخدم الطلب ويبحث عن الملف المطلوب ليعيده عبر الشبكة إلى التطبيق الزبون. 


تمثل الأسهم المتحركة باتجاه المخدم في الشكل الموضح ضمن الشريحةء طلب الزبون والذي يحدد فيه الصفحة التي يريد استقدامها من 
مخدم الوب» في حين تمثل الأسهم المتحركة باتجاه التطبيق الزبون استجابة مخدم الوب وإرسال المحتوى المطلوب إلى الزبون. 


جهة المخدم أم جهة الزبون؟ (2) 


نجد عند دراسة التفاعل بين مخدم الوب وزبون الوب» أننا أمام إحدى الحالات التالية: 
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الحالة 1 - تحتوي الصفحة على نصوص برمجية من جهة الزبون: تجري ترجمة وتنفيذ النصوص البرمجية المحتواة في 
SN SN orga E O ENON a‏ 


الحالة 2 - تحتوي الصفحة على نصوص برمجية من جهة المخدم: تجري ترجمة وتنفيذ النصوص البرمجية المحتواة في 
الصفحة التي أرسل الزبون في طلبهاء من قبل المخدم قبل إرسال الصفحةء نطلق على هذه النصوص» النصوص البرمجية من جهة 


المخدم ت 


الحالة 3- لا تحتوي الصفحة على أية نصوص برمجية (تحتوي على عبارات 11۷1 فقط): يرسل المخدم الصفحة إلى 


الزبون الذي يستعرضها. 

ملاحظة: 

يمكن أن تحتوي الصفحة على نصوص برمجية من جهة المخدم» وعلى نصوص برمجية من جهة الزبون» يجري عندها التفاعل بين 
زبون ومخدم الوب وفق الحالتين الأولى والثانية معا. 


ما أهمية النصوص البرمجية من جهة المخدم؟ (1) 


للإجابة على هذا السؤال ينبغي علينا الدخول في مقارنة بسيطة بين النصوص البرمجية من جهة المخدم والنصوص البرمجية من جهة 


الزبون من خلال سرد أهم النقاط الإيجابية والسلبية لكل منهما. 


النصوص البرمجية من جهة الزبون: 


النقاط الإيجابية: 

.DHTML مlدخٿتساب تساعد في دعم الحركة على الموقع‎ ٠ 

٠‏ تتحمل جزء من حمل المعالجة على المخدم حيث تتم عملية ترجمة وتنفيذ النص البرمجي على الحاسب الزبون. 

٠‏ تؤمن التفاعل مع المستخدم دون الحاجة إلى إعادة الاتصال مع المخدم (مثال عملية التأكد من بعض أخطاء البيانات المدخلة 

کی مرد مغن).: 

النقاط السلبية: 

لا تملك القدرة على الوصول إلى أي مورد من موارد المخدم» ولا إلى أي تطبيق من التطبيقات المتصلة به مثل 
تطبيقات إدارة قواعد المعطيات. إذ يكون المصدر الوحيد للبيانات التي يمكن للنصوص البرمجية من جهة الزبون 
الوصول إليهاء هي المعلومات المحتواة في الصفحة نفسها والتي تحوي» النص البرمجي» أو دخل المستخدم» أو 
معلومات من ملفات على جهاز الزبون (في حال تم منح الصلاحية للوصول إلى تلك المعلومات عن طريق المتصفح). 
توجد عدة لغات برمجة مُستخدمة في كتابتهاء مما يعزز فرص عدم توافقيتها الكاملة مع كافة المتصفحات ويجعل 
بعض المتصفحات غير قادرة على تصفحها. 
لايتوفر الأمان الكافي عند استخدامهاء إذ يمكن للزبون أن يستعرض بسهولة محتوى النصوص البرمجية من جهة 
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الزبون لأنها تكون جز من النص المصدري (الذي يمكن استعراضه بالخيار ۴٥0۲ء‏ wع‏ ا۷ من خيارات المتصفح) 
مما يجعل عملية استخدام أي نوع من التحقق أوكلمات السر من جهة الزبون غير آمن بالشكل الكافي. 


ما أهمية النصوص البرمجية من جهة المخدم؟ (2) 
النصوص البرمجية من جهة المخدم: 


النقاط الإيجابية: 
٠‏ تستطيع -كونها تعمل من جهة المخدم- الوصول إلى موارد المخدم والتطبيقات المرتبطة به مثل تطبيقات إدارة 
قواعد المعطيات. 
٠‏ يولد تطبيقها صفحات 1۲۷1 قياسية يستطيع أي متصفح تفسيرها واستعراضها أياً كانت لغة البرمجة المستخدمة 
في كتابة هذه النصوص البرمجية. 
لا يستطيع الزبون استعراضها لأن ما يصل للمستخدم هو نص 11۷1 ناتج عن تفسير وتشغيل النصوص 
البرمجية ما نجل ثري التضوص ارهج ة من جهة المخد أك امانا 


النقاط السلبية: 


٠‏ تعتبر عملية التفاعل في النصوص البرمجية من جهة المخدم بطيئة لأنها تتطلب الاتصال بالمخدم عند كل تفاعل. 


. يتحمل المخدم عبء عمليات ترجمة هذه النصوص البرمجية. 


التقنيات المستخدمة في النصوص البرمجية من جهة المخدم 


تاريخيأء جرى تطوير النصوص البرمجية من جهة المخدم» اعتماداً على لغات البرمجة التقليدية أو اللغات الخطاطية التقليدية 
متل € و ۲1ء۴ و امpااsc »She11‏ بحيث کان التطوير يعتمد على إنشاء ما yسمى٬‏ ب ) CGI (Common gateway interface‏ 
لتحصيل المعطيات التي يرسلها الزبون وللتعامل معها. وقد كان نظام التشغيل الذي يعمل عليه مخدم الوب» هو المسؤول عن عملية 
تنفيذ هذه البرامج بحيث كان يجري توجيه نتائج التنفيذ إلى تطبيق مخدم الوب. 


جرى حديثاً تطوير تقنيات أخرى» كتلك التي تعتمد لغات مثل ۸8۴ و ۶1ء بحيث يجري تنفيذها مباشرة من قبل مخدم الوب 
أو عن طريق وحدات برمجية إضافية وضمن فضاء العمل والعنونة المخصصين لمخدم الوب. 


من أشهر التقنيات المُستخدمة في تطويرالنصوص البرمجية من جهة المخدم: 
* ۔PER:‏ لم يجر تصميم هذه التقنية لكتابة النصوص البرمجية الخاصة ببيئة الوب» ولكنها أثبتت فعالية عالية في 
هذا المجالء وهي ما تزال مستخدمة لكتابة بر امج C61‏ والوحدات الخاصة بمخدم الوب ۸۴۸٣٤٩۴‏ نظراً 
لإمكانياتها الكبيرة في معالجة سلاسل المحارف» وهي العناصر التي يتم تبادلها بشكل أساسي في تطبيق وب. تأخذ 
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ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة ۲1. 


۶۴ جری تطوير هذه التقنية من قبل شركة مایکروسوفت» وهي تستخدم لغات مل مء Java‏ و VB‏ 
٤ء؟.‏ تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة ۲؟۸. 


:SP. N1‏ جرى تطوير هذه التقنية أيضاً من قبل شركة مايكروسوفت» وركزت على اعتماد البرمجة المقادة 
بالأحداث» واعتماد إطار عمل ."..8E1"‏ تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة 
.ASPX‏ 


:۴P۴‏ جرى تطوير ها كتقنية من تقنيات المصادر المفتوحة (عءإامء ممم 0)» وهي تكافئ تقنية ۸8۴ من حيث 
إمكانياتهاء مع تمتعها بميزة الإنفتاح وبإمكانية التطوير والتحسين والتوسع من قبل العديد من الجهات نظراً لكونها 

مفتوحة المصدر. تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة ۲۲4۲. 

01۴1s‏ : وهي نسخة تجارية من التقنية التي طورتها شركة هالع N2٥۲٠ ٣١‏ لدعم النصوص البرمجية من 

جهة المخدم. تتوفر هذه التقنية على أكثر من بيئة عمل و تدعم التعامل مع أكثر من نظام إدارة قواعد بيانات. تأخذ 


ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة .C۴‏ 


:۶P‏ وهي تقنية مبنية على لغة جافا لبناء نص برمجي من جهة المخدم. تتوفر هذه التقنية على أكثر من بيئة 
عمل (×ادs/01×/1س0لمW1)‏ . تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة ۲؟[. 


مخدمات الوب الأكثر انتشاراً 


:Apache pڏدخم‎ 


Apache 


HTTP SERVER PROJECT 


:IIS(Internet Information Services) a3خn‎ 


AN Windows Server System 


:Sun Java MicroSystem Web Server pڏخn‎ 
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Java 


POWERED 


ی 


:Apache pڏدخم‎ 

يعتبر مخدم ٥1ء2‏ م۸ نظام مفتو ح المصدر قدمته 0۸ Apache software unda‏ ویتوفر مع رازه مجاناً على منصات عمل 
.Windows «Novell «Unix «Linux‏ 

يتمتع هذا المخدم بالكثير من الخصائص المميزة نذكر منها: دعمه للعديد من لغات البرمجة متل ۲1عم» مطم» ودعمه للبروتوكولات 
الآمنة1؟S‏ و ۰118 وتوفيره لإمكانيات التحكم بشكل صفحات الخطأء بالإضافة إلى توفر رمازه على نحو مفتوح مما يسمح بتطويره 
وتحسينه ومعالجة تغراته بصورة أفضل وأسرع. يعد هذا المخدم من أكثر مخدمات الوب شعبية وانتشاراً على الإطلاق بحسب 
إحصاءات عام 2005. 


:IIS(Internet Information Services) aدخn‎ 

جری تطویر هذا المخدم من قبل شرکة ‰0۴٥إM¡c‏ و هو عبارة عن مجموعة من الخدمات المخصصة لبيئة الوب والتي تعمل على 
نظام التشغيل وس0 ل"1. يتم توزيع هذا التطبيق حالياً كخدمة من نظم التشغيل 2000 g Windows 2003 server gy Windows‏ 
Windows XP pro‏ 

تتضمن النسخة الحالية 6.0 118 خدمات °8 71 .۴P, SMTP, NNTP, H1 1 P/H‏ ویعتبر مخدم 8 المنافضس الأقوى 
لمخدم #طءةم4 من حيث الشعبية و الانتشارء ولكنه» وحتى نسخته الحاليةء يعاني من بعض نقاط الضعف وخصوصاً من النواحي 
الأمنية. وقد جرى تجاوز العديد من الثغرات في النسخة التجريبية 7.0 118 وجرى تصميمها على شكل وحدات ومكونات منفصل مما 
يضيف مرونة أكبر في التعامل مع هذه المكونات. 


:Sun Java MicroSystem Web Server aڏخn‎ 

جری تطویر هذا المخدم من قبل شركة M۲08٥‏ ہں؟ يُدعی حالیاً 0۸۴ .S7×N‏ يتميز هذا المخدم بخصائص أمان عاليةء 
ور اام مما كاه م كسا فطقت الل ك مط و لكر 

يتوفر المخدم على أغلب منصات العمل وهو يعطي العديد من الميزات للتطبيقات التي تستخدم تقنيات ۸۷۸[ و 8۴[ كما يدعم تقنيات 
ASP‏ و PHP‏ و تقنیات .°C61‏ 


مخدم 8اع7: 


تم تطوير هذا المخدم من قبل شركة رعهآام«طءء) وم7 وهو يحتل المرتبة الأولى من حيث السرعة منذ عشر سنوات» ويعمل على 
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تثبیت مخدم 118 
الخطوات التي تسبق عملية التشيت: 


التأكد من تغطية عتاديات المخدم للحاجات الدنيا لنسخة 118 التي نثبتها. مثلاء ينصح باستخدام مخدم بذاكرة أولية 512 
ميغابايت ومعالج ۲4 كحد أدنى» عند استخدام النسخة 6.0 118ء. 

التأكد من تثبيت عائلة البروتوكو لات 1۳۲/1۴ وذلك عن طريق إعدادات خصائص الاتصال الشبكي. 

إعداد القرص الصلب الخاص بمخدم 118 وتهيئته باستخدام نظام الملفات ؟N1۴.‏ 


نتتضمن عدة إصدارات من نظام التشغيل س0 ل۷1٠‏ المخدم 115 كإحدى خدماتهاء لتتبيت هذا المخدم نتبع المراحل التالية: 


2. نختار خيار إضافة أو إزالة برامج ونحدد خيار إضافة أو إز الة مكونات sس0لمW1‏ ونفعل خیار مخدم 118. 
3. يمكننا اختيار جزئيات النبيت من خلال النقر على زر كاأهامء5. 


ملاحظة: 
نلاحظ بالنقر على أيقونة sا0ها‏ م۷٤ه۲ئزمن‏ صل من خيارات لوحة التحكم ظهور أيقونة خاصة للوصول إلى 118. 


Internet Infarmatian SefYÎLES 
| Ssharktcuk 
| ZEB 


كما نلاحظ أيضاً أنه يجري تلقائياً عملية إضافة مجلد باسم N۴1۴8‏ ضمن القرص الصلب الذي يجري تثيت 118 عليه. 


واجهة إدارة مجموعة مخدمات 11S‏ 
تتكون واجهة إدارة 115» كما يظهر الشكل أدناه من قسمين رئيسيين: 


القسم الأيسر الخاص بإظهار مخدمات 118 العاملة على نفس الجهاز أو على عدة أجهزة ضمن الشبكةء بالإضافة إلى الخدمات 
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العاملة ضمن هذه المخدمات والمجلدات الرئيسية ضمنها. 
القسم الأيمن الذي تظهر فيه الفهارس الفرعية والملفات المحتواة ضمن هذه المجلدات. 


+ ğ Internet Information Ser¥ices 


Fil Arkin Yiaw Help 
EE EEE EDET 
Internet Information Seryices Hast Header | 


E- SKAIT local computer} efault Web Site (Stopped) stopped 
a-iı KEES 
HÊ Cefault Web Site (Stopped) 
EE Default SMTP virtual Server 


يقدم 59 خدمات متعددة» فهو يعمل کمخدم SMTP‏ وکمخدم FTP‏ إضافة لك عمله کمخدم وب. کما یمکننا تفعیل وإيقاف تفعيل 
أي من الخدمات باستخدام خيارات اإها؟ - وه - موه عبر النقر بالزر الأيمن على أية خدمة من هذه الخدمات. 


ملاحظة: 


يمكننا ضبط الإعدادات التلقائية لمخدم وب 118 بالنقر على الخیار ,٤۲ءم ۴۲٥‏ من قائمة شريط الأدوات. 


استضافة مواقع الوب في 118 


تعتمد الفكرة الأساسية في استضافة المواقع على إنشاء مجلدات تحتوي وثائق وصفحات ال 1۲۷1 المراد نشرهاء بالإضافة إلى 
فون ارو ف من ج اوو لرن جه اك اة 118 رر اا اي مل ات وا 
ويعيد المحتوى المناسب من المجلد المناسب. 


یُنشئ IIS‏ مجلداً تلقائياً باسم WwWw4‏ یعتبر المجلد الرئيسي التلقائي. کما يقدم IIS‏ آلية لإإضافة مجلدات أخرى وإدارتها. حیث 
تشكل هذه المجلدات جذر شجرة المجلدات التي تحتوي وثائق وصفحات مواقع الوب. 


يكفي لنشر صفحة وب تسميتها وفق إسم الصفحة التلقائية المحدد ضمن إعدادات مخدم الوب» ونقلها إلى المجلد التلقائي المحدد ضمن 
تفن اعاات اما بحت يكن امتح ارب كى الرصرل لها و اشر اا عق عد اتتا امك 
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ماهي المجلدات الاافتراضية؟ 


لتمكين وصول مستخدمي المتصفح إلى صفحات موقع غير محتواة ضمن المجلد الرئيسي التلقائي يمكننا إنشاء ما يسمى بالمجلد 


الافتراضي. 


يظهر المجلد للمتصفح وكأنه محتوى ضمن المجلد الرئيسي التلقائي بالرغم من كونه غير محتوى فيزيائياً ضمنه. 


يمتلك كل مجلد افتراضي اسم بديل (أو اسم مسار)»ء وهو الاسم الذي يستخدمه المستغزض للوصول إلى هذا المجلد ويكون عادة أقصر 
من المسار الفيزيائي الحقيقي لهذا المجاد. 


تؤمن المجلدات الافتراضية عدة مزاياء نذكر منها: 


1. درجة أمان أعلى كونها تحجب عن المتطفلين»ء المسار الفيزيائي الحقيقي للمجلد. 

2. سهولة عملية إدارة المخدم» وجعل عملية نقل الملفات فيزيائياً -من مكان إلى مكان آخر على القرص- عملية سهلة لا تسبب 
أي تغيير للعناوين المستخدمة ضمن الصفحات. 

3. سهولة استذكار المسار الافتراضي كونه أقصر من المسار الفيزيائي. 


إضافة مجلد افتراضي لاستضافة موقع 
لإضافة مجلد افتراضي بغرض استضافة مجموعة من صفحات الوب» ننقر بالزر الأیمن على خیار Deut Website‏ ثم نختار من 


القائمة سء الخيار رإهاءع۲ال اهن)۷1۲. تؤدي هذه العملية إلى تشغيل معالج خاص بإنشاء المجلدات الافتراضية. 


1. يطلب تحديد الاسم المُستخدم للوصول إلى هذا المجلد؛ 


2. يطلب تحديد اسم الموقع الفيزيائي لهذا المجلد على القرص؛ 
3. يطلب تحديد صلاحيات الوصول لمحتويات هذا المجلد. 


بعد ضبط هذه الإعدادات يصبح بإمكاننا وضع ملف من نمط ا11 ضمن المجلد الفيزيائي الحقيقي الذي يمثله المجلد الافتراضي 
ويصبح بإمكاننا استعراضه عن طريق متصفح الوب» حيث يمكننا الوصول إلى محتوى صفحة الوب مباشرة باستخدام محدد الموارد 
القياسي 1ا . 


مال : 


5ق بكقابة مخت المررد القاني: 
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http://10.12.17.5/myweb/test.html 


فإذا كان لدينا مخدم 0×8 نستطيع ربط اءسره/11://10.12.17.5 باسم نطاق معين فيصبح محدد الموراد القياسي من الشكل: 


http://mydomain.com/test. html 
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النماذج في XHTML‏ 


أهداف تعليمية: 
يتعرف الطالب في هذا الفصل على: 
XHTML js >and .1‏ 
2. النماذج في XHTML‏ 
3 عناصر XHTML gila‏ 
ه الحقول النصية 
ه حقول الاختيار 
ه الأزرار 
الحقول المخفية 


ما هي XHTML؟‏ 
هو عبارة عن معيار متقدم عن المعيار 1114.0[ جرى وضعه لبناء نسخة 1111 متوافقة تماما مع الشروط الصارمة للمعيار 


× من ناحية أسلوب كتابة التأشيرات» واحترام إغلاق كل تأشيرة مفتوحةء والتركيز على التداخل الصحيح للتأشيرات» وعدم 
التسامح في تجاوز بعض التأشيرات» واستخدام الفواصل: (' ') لتحديد قيم الواصفات مثل ”عں1ة۷”=ع u)‏ طنءا)۸ء وغيرها. 


النماذج في XHTML‏ 


الغرض من النماذج: 

1. تعرّف النماذج بأنها آلية تهدف إلى جعل صفحات ا11 أكثر تفاعلية. وثسمح النماذج لمستخدمي صفحة الوب بتوزيع 
البيانات ضمن حقول محتواة في صفحة ا11 وإرسال هذه البيانات إلى مخدم الوب حيث تجري معالجتها. 
يتدر ج تعقيد تفاعلية النماذج من حقل بحثِ بسيطء إلى نموذج خاص بنظام بيع وشراء متكامل عبر الشبكة» أو إلى نظام 
ا ا کا فن اتم ن خان مات كما عات 


وتات الفموڈج: 
1. يتكون النموذج من حقل إدخال أو أكثر. يمكن أن تكون هذه الحقول» حقول إدخال نصية» أو أزرارء أو مربعات اختيار » أو 
قوائم» أو حتى خرائط صور. 
تكون عناصر النموذج محصورة بين التأشيرتين: <صإه؟/> <دطإه>. 
يحتوي النموذج مكونات ]1۲۷ آخرىء» فهو لايقتصر بالضرورة على عناصر النموذج. فعلى سبيل المثال» يمكن للنموذج 
أن وي ترا و صروا ساف في شرح ية مل فول الودج): كبا يمن الودج أن يحون اى لصون 
برمجية من جهة الزبون» مكتوبة بلغة أمأإه5ة۷ه[ أو غيرهاء تساعد في عملية تقييم البيانات. 
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عند إرسال النموذج للمعالجةء يُرسل المتصفح بيانات الحقول إلى المخدم لمعالجتها أو إلى عنوان بريد إلكتروني أو إلى نص برمجي 
من جهة الزبون. يُعبر الشكل التالي عن نموذج تقليدي: 


cE samir 
ESE ahmad 
Password 
Sex fF Male Û Female 
Lountry Select A, Country ¥ 


Address damascus syria 


Submit Reset 


عناصر النموذج: الواصفة M٤10١‏ 


تحدد هذه الواصفة أسلوب إرسال البيانات وطريقة إرسال طلب 111۳. تميّز هذه الواصفة حالتين: 

1 حالة نموذج يستخدم طريقة ۲081: حيث يجري توجيه المتصفح لإرسال البيانات إلى مخدم وب أو إلى عنوان بريد 
إلكتروني» ضمن أغراض خاصة يتضمنها الطلب 1۲۲۶ المُرسل إلى المخدم. 
حالة نموذج يستخدم الطريقة :6٤1‏ حيث يجري توجيه المتصفح لإرسال البيانات إلى مخدم وب أو إلى عنوان بريد 
إإكتروني» على شكل سلسلة محارف تضاف إلى المُحدد 0۸1 ضمن طلب 1١۲۴‏ المُرسل إلى المخدم. 


بالإضافة إلى طريقتي 6٤1‏ و ۲081 هناك العديد من الطرق الأخری لإرسال طلب 1۲۲۲ مثل الطرق 0ء eاعاء5ء‏ 
َء nne‏ لكننا سنتعامل حصرياً مع الطريقتين 6٤1‏ و ۴081ء وسنستعرض لاحقاً الفروق الأساسية بين هاتين 


عناصر النموذج: الواصفة ر0ذاA‏ 


تحدد الواصفة ١٥ء4‏ للمستعرض العنوان الذي يجب أن تصل إليه البيانات المُرسلةء إذ يمكن أن تكون القيمة المُسندة 
تتم عملية الإرسال»ء والوصول إلى العنوان المحدد في الواصفة 0ءء عند نقر زر الإرسال ٤إ‏ طا؟. 


<EORM METHOD POSE ACTION TSKECSCES Nel. OILS 
. Content 
</FORM> 


يقوم هذا النموذج» عند ضغط زر 51,1 بحزم البيانات و إرسالها كرسالة بريد إلى عنوان البريد المحدد في المثال -وءء@SK‏ 


: HEE. OF 
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HORM MEN HOD ONE ELON GEC UNEO APSA 
. COPEEnNE 
</FORM> 


يقوم هذا النموذج» عند ضغط زر اط ط»ا؟» بحزم البيانات وإرسالها إلى الملف ×مءه.ه؟,آاهع على المخدم والذي يحتوي النص 
البرمجي الخاص بمعالجة البيانات المُرسلة. 


مثال 3: 


<FORM METHOD=”GET” ACTION=”Test.php”> 
. Content 
</FORM> 


يقوم هذا النموذج» عند ضغط زر ا81 بإرسال إلى ملف مطم.اءه1 وذلك بإضافة البيانات إلى محدد 0۸1 الخاص بالصفحةء 
فإذا كانت إحدى الحقول المراد إدخالها هي 14۳# وكانت قيمة الحقل هي iصهءء‏ يظهر محدد R1‏ عند الإرسال» بالشكل التالي: 


http://myDomain.com/Test.php? name=sami 


عناصر النموذج: الواصفة ٤م‏ رآ٥٤‏ 


تحدد الواصفة ٠مرE101‏ نمط الترميز المُستخدم عند إرسال بيانات النموذج. تأخذ هذه الواصفة قيمها من أنماط المعيار 
[M٤‏ وهو معيار يو صف أسلوب ترميز البيانات» جرى تطويره لترميز البيانات المختلفة ضمن شكل نصي وباستخدام 


حروف الأبجدية. 


يجري تحديد نمط الترميز على النحو التالي: MME ype/MIMESub 1 ypم ٤e‏ . فعلى سبیل المتال يظهر نمط الترميز 
التلقائي والذي يُعبّر عن القيمة التلقائية للواصفة ٠مرآء"E‏ كما يلي: 

<Form O OT ET TN TG TE TT TEES ٠ 
حيث يصلح الترميز السابق لجميع نماذج الوب عدا تلك التي تتطلب إرسال ملفات إلى مخدم الوب» والتي يجري فيها‎ 
استخدام القيمة:‎ 


<Form ENCTYPE=multipart/form-data> 


عناصر النموذج: الواصفة AcceptCha1S¢t‏ 


النماذج متعددة اللغات. تكون القيمة التلقائية لهذه الواصفة 7N N0 W١‏ التي تشير إلى استخدام نفس قائمة المحارف 
المستخدمة في ترميز النموذج. 


عند الحاجة لاستخدام أكثر من قائمة محارف» يمكن وضع قيم الواصفة السابقة على شكل قيم متتالية يجري فصلها بفاصلةء 
كما هو الحال في المثال التالي: 


<EoOrmM AccepLCharsel “windows 1256,150 08059 15 
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عناصر النموذج: الواصفة )ع۲١1‏ 


تستخدم الواصفة ا#ع۲ة1 في بيئة الصفحات متعددة الأطر. تعبر قيمة هذه الواصفة عن اسم الإطار الهدف الذي ستظهر فيه الإجابة 
بعد إرسال النموذج (في حال أعاد النص البرمجي من جهة المخدم آي خرج). فى سبيل المثال» تستخدم هذه الواصقة عند الحاجة 
لإدخال بيانات خاصة بنموذج بحث متوضع ضمن إطار ما في صفحة 11M‏ وعند الحاجة لاسترجاع نتيجة البحث ضمن إطار 


آخر. 


تأخذ الواصفة ا#ع۲ه) القيم: 


. صهاطا_“: تجري إعادة خرج النموذج في نافذة جديدة بدون اسم. 


1 
self? 2‏ “: تجري إعادة خر ج النموذج ضمن نفس الإطار الذي يحوي النموذج. 
3. 
4 


parent”‏ “: تجري إعادة خرج النموذج ضمن الإطار الأب للإطار الذي يحوي النموذج. 


99 


مه _“: تجري إعادة خرج النموذج ضمن الإطار الرئيسي مع إزالة كل الإطارات الأخرى. 


<form action=” SomeThing.aspx” method=” POST” Target=” blank” > 


:ONRESET y ONSUBMIT ثٿlدحألا‎ 


يجري تنفيذ الحدث ©١NR۸ ٤5٤1‏ عند إلغاء معلومات النموذج بضغط أع؟ع] . 


<form action=”test.aspx” method=” POST” onsubmit= ”window.alert( submitted successfully”); > 


تظهر« عند إرسال هذا lلiنموذج«‏ lلرluة “submitted successfully”‏ 


عناصر النموذج: واصفات أخرى 


لا تقتصر واصفات وأحداث النماذج على تلك التي قمنا بشرحها في الشرائح السابقةء إذ توجد واصفات وأحداث أخرى سنذكر بعضها 


من هذه الواصفات: 


15 ستخدم هذه الواصفة اتحديد اسم فريد التموذج. 


- sووا:‏ تستختم هذه الواصفة قي حال الرغبة باستعمال الأنماط الخاصة بملفات 0K88‏ المعرفة ضمن التأشيرة #ار؟ من 


نفس الوثيقة. 
ف ا ار ریف عاط ري ااا في ق فا ا 

6ا7 تخ اتسديد عتران التصر حيت يسيد المتصفح من قيمة هذه الواصفة لإطهار مربع بتري هذه القيمة لدئ 
مرور مؤشر الفأرة فوق العنصر. 
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ومن هذه الأحداث: 


طف غ دن طط ئ نخ لأ م ف6 


ى 
© 


&1اONC‏ يجري تتفيذ الإجرائية المُسندة لهذا الحدثء عند النقر بالزر الأيسر فوق العنصر. 

NDB LCL CK‏ يجري تنفيذ الإجرائية المُستدة لهذا الحدث» عند النقر المزدوج بالزر الأيسر فوق العنصر. 
©NMOUSEDOWN‏ يجري تنفيذ الإجر ائية المُسندة لهذا الحدث»ء عند الضغط بالزر الأيسر فوق العنصر. 

©NMOJSE 1P‏ يجري تنفيذ الإجرائية المُسندة لهذا الحدث»ء عند تحرير الضغط عن الزر الأيسر فوق العنصر. 
N NMOUSEOVER‏ يتم يجري تتنفيذ الإجرائية المُسندة لهذا الحدث» عند وضع مؤشر الفأرة فوق العنصر. 
O NMOJSEMOVE‏ يجري تتفيذ الإجرائية المُسندة لهذا الحدث»ء عند تحريك مؤشر الفأرة فوق العنصر. 
ONMOUSEOUT‏ يجري تتفيذ الإجرائية المُسندة لهذا الحدث» عند خروج مؤشر الفأرة من المساحة التي يحددها العنصر. 
NK E۴8‏ يجري تنفيذ الإجر ائية المُسندة لهذا الحدث» عند ضغط وتحرير مفتاح فوق العنصر. 

NK ٤YDOWN‏ يجري تتفيذ الإجر ائية المُسندة لهذا الحدث» عند ضغط مفتاح فوق العنصر. 


NK EY .‏ يجري تتفيذ الإجرائية المُسندة لهذا الحدث» عند تحرير مفتاح فوق العنصر. 


عناصر النموذج 


<form method=” POST” action=”Test.aspx” 

target” self’ ID=”myForm” 

class=” normalForm” EncType=”multipart/form-data” dir=”ltr” 
onclick=”window.alert( ‘you clicked the form)” > 

... Contents 

</form> 


يستعرض هذا المتال نص ا11۷ يعرف نموذج يعتمد على الطريقة ۴051 في إرسال البيانات. 

يحدد النموذج الملف ×مءه.اوهء كملف هدف يحتوي نصا برمجيأً من جهة المُخدم ويجري إرسال البيانات إليه للمعالجة. 
تظهر الاستجابة على هذا النموذج (كنتيجة لتنفيذ الملف ×صءه.ءه) ضمن نفس الإطار الذي يظهر فيه النموذج» لأن النموذج 
استخدم القيمة ”61۴؟_“ . 

يمتلك النموذج السابق الإسم ”٣۴۲ر“‏ ويجري تطبيق النمط ”۲۳٠21۴٠٣إهم“‏ على هذا النموذج (لا بد أن يكون هذا 
النمط معرف مسبقاً ضمن وثيقة C88‏ أو ضمن نفس الوثيقة باستخدام التأشيرة 1۴ .)8١۷‏ 

يُستخدم في هذا النموذج الترميز ”هة ل-١١١إ۴0/١4م11سم“‏ مما يعني أن النموذج يُرسل محتوى ملف إلى المخدم. 

تظهر الرسالة ٤٥۲٥”‏ عط dع)ءذاء‏ uم“‏ عند النقر على النموذج. 


حقول النماذج: الحقول النصية 
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يمكن استخدام عدة أنواع من الحقول النصية في النموذج نستعرضها فيما يلي: 
حقل إدخال نص : 
1. تز حقول إدخال النصوص من أكثر أنواع الحقول استخداماً في النماذج. يتألف حقل إدخال النص من حقل فار غ مخصصر 
لإدخال سطر وحيد. 


حيث تقاس ع812 و طاعمعآ×ه" بعدد المحارف. 
. يمكن أن تكون الواصفة طاعمءا×ه ص أكبر من الواصفة م81z.‏ في هذه الحالة يجري زلق محتويات الحقل النصي أثناء 
الكتابة. 
4. يمكن استخدام الواصفة عںآاه۷» لإعطاء قيمة تلقائية للحقل. 


لا يوجد في 1۲1 أية آلية مباشرة للتحكم بنوع المدخلات» لذا نلجاً إلى النصوص البرمجية من جهة الزبون» أو إلى النصوص 
البرمجية من جهة المخدم» لتقييم البيانات وإظهار رسائل الخطأً في حال عدم تطابقها مع نمط أوتنسيق البيانات المطلوبة. 


مال : 


لإنشاء حقل نصي باسم 18م 84۳ر" يحتوي على قيمة تلقائية هي ءه)ء ويكون بطول 10 محارف» وبعدد أقصى من المحارف يبلغ 


<input type=”text” name=”mySample” value=” test” size=”10” maxlength=40 


4 
حقول النماذج: الحقول النصية 


حقل إدخال كلمة السر: 


. يستخدم هذا النمط من الحقول النصية كالحقول النصية العادية مع تطبيق قناع يخفي المحارف المُدخلة. إذ لا يتمكن الناظر ! 
يستخدم من : : يه مع تطبيق قناع يخفي ر إِذ لا یتمكکن 1 
الشاشة من رؤية المحارف» بل يرى عوضا عنها محرف القناع الذي غالبا ما يكون أحد المحارف "0" أو ”*“ 

. يجري إظهار المحرف القناع ('0' أو ”*“) أثناء عملية الإدخال أمام الناظر إلى الشاشةء ولكن هذا لا يعني أن المحارف 
تكون مقنعة بالنسبة للبرامج العاملة على الجهاز الذي تجري عليه عملية الإدخال أو أثاء عملية إرسال البيانات إلى المخدم. 


<input type=”password” name=“”myPass” size=”10” maxlength=25 /> 


حقول النماذج: الحقول النصية 
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حقل إدخال اسم ملف: 


1. يسمح هذا النمط من حقول الإدخال النصية للمستخدم باختيار ملف حتى يجري إرساله إلى المخدم. 
2. يكون اسم الملف محتوى في نص يعبر عن المسار الذي استخدمه المتصفح للوصول إلى الملف. 
3. يقوم هذا النمط بإظهار الحقل النصيء إضافة إلى زر يساعد في استعراض المجلدات بحثاً عن الملف المطلوب. 
4. ليعمل هذا الحقلء لا بد من استخدام الطريقة ۴051 في إرسال بيانات النموذج وعدم استخدام الطريقة آ٤6.‏ 
5. يمكن استخدام الواصفة امءءء۸ مع هذا النمط للسماح بإرسال نمط معين من الملفات. تحدد قيم الواصفة 1م٥٥٥۸‏ بنمط 
M[M٤‏ للملفات المراد إرسالها. 
مال : 


<input type=”file” size=8 name=“”myFile” accept=”text/*” />‏ 
في هذا المتالء يجري إنشاء حقل من نمط حقل ملف بإسم »my۴e‏ بحیث يیکون عرض الحقل 8 محارف» وبحيث يقبل هذا الحقل 
الملفات من النمط ٠×٤‏ بجميع أنماطه الفر عية متٹل ر .„(text/html, text/css text/plain)‏ 


عناصر النماذج: الحقول النصية 


حقل إدخال نص متعدد الأسطر: 


يساعد هذا النمط من الحقول في إدخال نص متعدد الأسطر وذلك باستخدام التأشيرة <۴۸ .>1٤×X1۸R‏ 


من أهم الواصفات الخاصة بهذه التأشيرة: 
الواصفة وس R0‏ التي تحدد عدد الأسطر؛ 
الواصفة 1ه التي تحدد عدد الأعمدة؛ 
الواصفة م۵س التي تحدد قابلية النص للالتفاف عند تجاوز عرض مساحة النص. يمكن لقيمة الواصفة أن تأخذ إحدى القيم 
“off‏ أو “virtua”‏ أو ”اaعزووطP“»‏ حيث تساعد القيمة ”۴۴“ في تعطيل التفاف النص» بينما تساعد القيمة ”41 ن٣٣¡“‏ 
في تثبيت التفاف النص ولكنها لا تقوم بإضافة أي فاصل إلى البيانات التي يجري إرسالها بعكس القيمة ”41ء1وط۴“ التي 
تضيف فاصل سطر حقيقي عند كل التفاف للنص ويجري إرساله مع البيانات عند إرسال النموذج. 


<TEXTAREA rows=”10” cols=*”6” name=“”myTextArea” wrap=”off”> 
This is a test 
SATE TAREAS 


يُنشئ هذا المثال مساحة نصية بعرض 6 محارف وارتفاع 10 محارف باسم 4۲۴4ا×٥1ل"‏ ويجري في هذا النموذج تعطيل خاصة 
التفاف النص. 
حقول النماذج: حقول الاختيار 
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يندرج تحت هذا التصنيف الحقول ذات الأنماط التالية: 


ينشئ هذا النمط من الحقول عنصر يمكن تفعيله أو إزالة تفعيله. 
يكون الشكل التقليدي لهذا النمط عبارة عن مربع تظهر فيه إشارة × عند اختياره. 
عند إرسال النموذج» يجري إرسال قيم العناصر المُختارة وهي قيم العناصر التي تظهر أمامها إشارة ×. لذا يجب أخذ هذا 
الموضوع في الحسبان أثناء كتابة النص البرمجي الذي يعالج البيانات المُرسَلة. 
تعتمد القيمة التي يجري إرسالها في هذا النمط من الحقولء على القيمة المسندة للواصفة عuاج.‏ 
يمكن تفعيل حقل التحقق تلقائياً عند إظهار النموذج وذلك عبر إضافة الواصفة ”4٤ء1٤“‏ إلى التأشيرة. لا تأخذ الواصفة 
“checked”‏ أية قيمة ولكن» للالتزام بقواعد كتابة الواصفات» نسند لهذا النوع من الواصفات قيمة مساوية لإسم الواصفة 
igكتيlq: Checked=”Checked”‏ 
مال : 
<input type=”checkbox” value=” test” name=”myCheck” Checked=”Checked”‏ 


/> 


حقول النماذج: حقول الاختيار 
أزرار الراديو: 


يشبه شكل هذا النمط من الحقول» شكل خيارات قنوات الراديو حيث يمكن اختيار خيار واحد فقط من الحقول التي تنتمي إلى 
مجموعة وأحدة. 

تعتمد القيمة التي يعيدها النموذج» كما هي الحال مع مربعات التحقق» على القيمة المُسندة للواصفة عںآة۷. 

يمكن تفعيل حقل التحقق تلقائياً عند إظهار النموذج وذلك عبر إضافة الواصفة ”dء)ءءط)“‏ وإعطائها القيمة ”لء)ء عط“ 
كما هو الحال في حالة مربعات التحقق. 


<input type="radio" name=/”myRadio” vaue=“”optionl” checked=“checked” /> 
TITSE OOELOR E> 
<input type="radio" name=“”myRadio” vaue=“option2” /> second option <br> 
<input type="radio" name=“”myRadio” vaue=”option3” /> third option 


يظهر عند تنفيذ النص أعلاه النتيجة التاليةء حيث يجري إرسال القيمة ”«٠0نامه‏ عت“ وفقاً للاختيار المبين في الشكل: 


f first option 
f second option 
f third option 


عناصر النماذج: حقول الاختيار 


Universal Knowledge Solutions s.a.1. 
18 


. تستخدم قوائم الاختيار التأشيرة <اءه1م5> لإنشاء نمطين أساسيين من القوائم: 
ه. القوائم المنسدلة 
ا. القوائم القابلة للزلق. 

. يساعد كلا النوعين في تنفيذ عملية اختيار خيار واحد أو عدة خيارات من قائمة خيارات. 

. يجري تحديد عناصر القائمة بالتأشيرة <١10امه>‏ حيث يجري تضمين كل خيار ضمن القائمة باستخدام التأشيرة 
.<option></option>‏ 

. يجري إرسال المتحول المُحدد يالواصفة مص هه؛ عند إرسال النموذج» خملا بقيمة الخيار المحدد ب ١٥امه‏ في حال قام 
المستخدم باختيار وحيد. أما في حالة الاختيار المتعدد» فيجري تحميل متحول يمتل قائمة خيارات مفصولة عن بعضها البعض 
بفاصلة. 

. يكفي إضافة الواصفة ءامااuم‏ وإعطائها القيمة ”٥1م1٤اuامص“‏ لتحديد إمكانية استخدام عدة خيارات في قائمة الاختيار 
المعنية. 

. يستطيع المستخدم» عند تفعيل خاصة الاختيار المتعددء اختيار أكثر من عنصر في القائمة بضغط زر C1۸]‏ والنقر على 
الخيارات المطلوبة. أما في حال عدم تفعيل هذه الخاصة»ء فإن قوائم الاختيار تعمل بنفس الآلية التي تعمل بها أزرار الراديو 
حيث تسمح باختيار خيار واحد فقط من مجموعة خيارات. 

. تتحكم قيمة الواصفة S120‏ بارتفاع قافة الألختتار. القابنة لاز لاق و عشما شك إلى هذه الواصفة القيمة ٠1”‏ يجري إظهار 
سطر واحد من القائمة» وتتحول هذه القائمة إلى قائمة منسدلة. 
لا توجد واصفة خاصة للتحكم بعرض قوائم الاختيار إنما تأخذ القائمة العرض اللازم لاحتواء الخيار صاحب العدد الأكبر من 


. يجري تحديد خيار تلقائي أو مجموعة من الخيارات التلقائية باستخدام الواصفة لعاءءاعS‏ وبإعطاءها القيمة ”عع 1ء8“ 
وذلك ضمن التأشيرة ١٥1امه‏ لكل خيار من الخيارات المعنية. 


یمکن إنشاء مجمو عات فرعية من الخيارات ضمن قائمة الخيارات الواحدة وذلك باستخدام التأشيرة <Optgroup>‏ وحصر 
جميع خيارت المجموعة الفرعية ضمن هذه التأشيرة. 


<select name="select"> 
SOPEIEOUp label NOvVElal> 
<option value="1">Damascus</option> 
<option value="2">Aleppo</option> 
<option value="3">Lattakia</option> 
ODEGEOUDS 
<optgroup label="Jordan"> 
<option value="4">Amman</option> 
<option value="5">Alakaba</option> 
LODE OU 
</select> 
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[Damascus 3 i 

` Damascus 

` Damascus Aleppo 
Alp p0 Lattakia 
Lattakia Jordan 


Jordan Amman 
Amman Alakaba 


4lakaba 
S؟S1zع=[1 الواصفة 7=عS1z حالة الواصفة‎ 


عناصر النماذج: الأزرار 


هناك ثلاثة أنواع أساسية للأزرار التي يمكن إضافتها إلى نموذج: 
أزرار الإرسال و إعادة تأهيل النموذج: 


يساعد زر الإرسال في إرسال بيانات النموذج إلى المخدم حتى تجري معالجتها عبر الملف المحدد في الواصفة A0١‏ 
الخاصة بالنموذج وذلك باستخدام الطريقة المحددة في الواصفة ل610 المرتبطة بالنموذج. 

يستخدم هذا النمط الوسم خلام1] على أن يتم إسناد القيمة 7٣1ص‏ طں؟“ إلى الواصفة مرا 

يمكن استخدام التأشيرة ١0ط‏ لتأدية نفس الوظيفة . 


<input type=”submit” name=”test” value=” Send”> 


<button type=* submit” name=”test” value=“ myValue“”>text on 
DULLON< /OULEON> 


يؤدي زر إعادة تأهيل النموذج ٤6ء٠۸‏ إلى إفراغ الحقول من جميع القيم التي تم إدخالها من قبل المستخدم دون إرسال أية 
بيانات إلى المخدم. 

يمكن استخدام التأشير ة ٤نامه]‏ أو التأشيرة ١٠٥انط‏ لتحديد زر من هذا النمط بشرط إسناد قيمة ”۸56“ إلى الواصفة 
Type‏ 


<input type=”reset” value=” reset”> 


<button type=“”reset” >text on reset button </button> 


Universal Knowledge Solutions s.a.1. 
20 


عناصر النماذج: الأزرار 


الأزرار من نمط صورة: 


يُستخدم هذا النوع من الأزرار بهدف إضفاء جمالية على النموذج عبر تمثيل زر الإرسال بصورة . 
يجري استعمال التأشيرة لام1 مع إسناد القيمة ”#عةد٠1“‏ إلى الواصفة عمرا. 
يجري تحديد ملف الصورة المُستخدمة بإسناد المسار النسبي أوالمطلق لملف الصورة على المخدم إلى الواصفة ١١إ؟.‏ 


<input type=”image” src=*”./images/myImage.gi 1 


عناصر النماذج: الأزرار 


الأزرار متعددة الأغراض: 


يساعد هذا النمط في إنشاء أزرار ذات أغراض متعددة مختلفة عما أوردناه حتى الآن. 


يجري في هذا النمط من الأزرار استخدام الأحداث لتحديد الفعل ورد الفعل. 


تستلزم هذه الأزرار استخدام نص برمجي من جهة الزبون. 


تستخدم هذه الأزرار التأشيرة ٤امه!‏ أو التأشيرة ١٤ا8‏ بعد إسناد القيمة ١٥ا٤8‏ إلى الواصفة عمطرا. 


BUE EON 


<InNPUL type BUL EON 
value="Please Don't Press This 


onclick="window.alert ('any message.')" 


<BUEEONn CEyYBe "BDULLORN 
value="anyValue" 


onclick="window.alert (any message.'")"> 'Please do not press 


this SULLON again. </SUttLON> 


جرى في المتال السابق الإشارة إلى حدث الضغط على زر» بنص برمجي من جهة الزبون يقوم بإظهار رسالة. ويكمن الاختلاف 
الرئيسي بين ١0ا8‏ و ام1 في أن التأشيرة 8)٥١‏ تأخذ قيمة النص الموجود على الزر من النص المحصور بالتأشيرة» أما في 
حالة التأشيرة لام1 فيتحدد النص الموجود على الزر بقيمة الواصفة مناه الخاصة بهذه التأشيرة. 
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عناصر النماذج: الحقول المخفية 


الحقول المخفية: 


.1 


رل اة من تقار اة في ا ع ره كوا عر ر الکو ك ف ها الط من الكرل لى 


يُستخدم هذا النمط من الحقول عادة في حالتين: 

٠‏ لتمرير قيم إلى المخدم ليس لها أي دلالة للمستخدم» حيث يستفيد من هذه القيم النص البرمجي الذي يعالج المعطيات من 

٠‏ لتمرير معلومات يجب أن تبقى غير مرئية للمستخدم لأسباب تتعلق بسريتها. إذ يضمن إخفاء بعض المعلومات المُرسلة 
بهذه الطريقة حمايتها من المستخدم البسيط أو المبتدأً. 


يستخدم هذا النمط من الحقول التأشيرة امه بعد إسناد القيمة ””٥ل‏ ل11“ إلى الواصفة ءمرا. أما القيمة التي يجري 
إرسالها عند إرسال النموذج فهي القيمة المُسندة إلى الواصفة #uاج۷.‏ 


مثال: 


<input type=” hidden” name=”myHidden” value=“”value we want to hide” /> 


تكون أحد القيم التي تصل إلى المخدم» في حال جرى إرسال نموذج يحتوي النص أعلاه» هي القيمة: 
myHidden=value we want to hide‏ 
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تمرين عام 


نريد إنشاء نموذج يعمل على جمع المحددة فيما يلي لإرسالها إلى ملف باسم .register.asp×‏ نفترض أن النموذج يمتلك الشكل التالي: 


Login Name 
Password 
Full Name my full narme 
SEX 
Address 


any addrezs 


Emaıl ski@scs-net.org 
type of membership MASTER MEMBERSHIP 
picture File Browse... 


interested in 


Submit 


CI DOCTITSES HT FUELLEGE MOC DED OT 4 Trance 
BEEP: WWW WI. OEOLIR REMI A/ 1 OOS. AEA > 

CHEMI Z 
<head> 
le>Test Form</title> 

Ltp-equiv="Content-Type" content="text/html; charset=iso-8859- 


le type="text/css"> 


lel EOE: EBERT 


</style> 
</head> 


SBOdyz> 

<form action="register.aspx" method="post" enctype="multipart/form- 
dalal > 

<tablé Width "340" border "2" cGellpadding="0" CellSBACINgG NO 
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bordercolor="FFFFFFF"> 

E> 
<th width="185" bgcolor="#666666" scope="row"><span 
class="stylel">Login Name</span></th> 
<iEd GOlSpan "2"><inNpUt name "lO0IN LDPE lexXl" 104 "lO1 </td> 
EES 
GEEZ 
<th bgcolor="#666666" scope="row"><span 
class="style1l">Password</span></th> 
<td colspan="2"><input name="pass" type="password" id="pass"></td> 
CEES 
SEE 
<th bgcolor="#666666" scope="row"><span class="stylel">Full Name 
€7 SPN ></ R> 
td colspan="2"><input name="ful lIName" type="text" 
id="fullIName"></td> 

EE 

EE 
<th bgcolor="#666666" scope="row"><span 
Class Stylel Sex</Spanz<s/Eh> 
<td width="64"><input name="sex" type="radio" value="male"> 
male</td> 
<td width="81"><input name="sex" type="radio" value="radiobutton"> 
female</td> 
EES 
SEE 


<th colspan="3" bgcolor="#666666" scope="row"><span 
class="style1l">Address</span></th> 
E 
GEEZ 


<th colspan="3" scope="row"><textarea name="address" cols="50" 
1d="textarea"></textarea></th> 
CEE 

SEE 
<th bgcolor="#666666" scope="row"><span 
class="stylel">Email</span></th> 
<td colspan="2"><input name="email" type="text" id="email"></t 
CE 
SEE 
<th bgcolor="#666666" scope="row"><span class="stylel">type of 
membership</span></th> 
<td colspan="2"><select name="select"> 

<option>MASTER MEMBERSHIP</option> 

<option>NORMAL MEMBERSHIP</option> 

<option>GUEST MEMEBERSHIP</option> 

</select></td> 
</EE> 
SEE 
<th bgcolor="#666666" scope="row"><span class="stylel">picture 
Ele SAR JER 
<td colspan="2"><input name="myPicture" type="file" id="myPicture"™ 
Si2€6 10 CEA 
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EES 
SUEZ 
<th colspan="3" bgcolor="#666666" scope="row"><span 
class="stylel">interested in </span> VERS 
SEE 


SEZ 
<th colspan="3" scope="row"><select name="select2" size="5" 


tiple> 
<OPLI1OR-SPOLLE<S/OPLI1OA > 
<OPE1 ON EdUcCAaE1ON</OPDE1 ON > 
<option>shopping</option> 
CODLIOR CEILS OPO 
<OPpE1ORN-OtENeEE 1nNEerESES</OPE1LONZ 


tiohz </Option> 


SEE 
EES 
EE 
<th scope="row">&nbsp;</th> 
<td colspan="2"><input type="reset" name="Submit2" value="Reset"> 
<input type="submit" name="Submit" value="Submit"></td> 
AER 
</table> 
€/FOEM> 
</body> 
</REML> 
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طلب ۳1۲۲۲ باستخدام الطریفتین ۴0S1‏ و GET‏ 


يتعرف الطالب في هذا الفصل على: 
. طلبات HIT T°‏ 
. طرق إرسال الطلبات 
. طريقتي آ٤6‏ و ۴051 و الشروط المثظى لاستعمالهما 
. الطرقة HTTP POST ةقيرطلl, HTTP GET‏ 


ذكرنا في جلسة سابقة أثناء استعراضنا للتأشيرة ”ط۲٠۴“‏ الواصفة “٧16٤104”‏ و بيّنا إمكانية إسناد إحدى القيمتين ”۶۴051“ أو 
67“ لهذه الواصفةء وذكرنا أن هذه الواصفة تحدد كيف سيجري إرسال البيانات أو الطريقة التي ستعتمد لإرسال طلب .H1۲۲۲‏ 


لفهم الفرق بين هذين الطريقتین لا بد لنا من شرح بسيط لأجزاء طلب بروتوکول 1۲۲۴. 


البروتوکول ۲۲۲ :H‏ 
يعد البروتكول [١7۴‏ البروتوكول التطبيقي الأساسي المُستخدم لتناقل البيانات على شبكة الأنترنت. 
ويعتمد البروتوكول 1١١۲۶‏ آلية (طلب/استجابة) بين التطبيق الزبون (المتصفح) والتطبيق المخدم (مخدم الوب) 


طلب :H1 1P‏ 
تبداً مناقلة 1۲۲۶ بإرسال طلب 117۲ . 
يتكون طلب 1١۲۴‏ من مجموعة من الأجزاء كما يظهر في الشكل التالي. سنستعرض فيما يلي هذه الأجزاء ونحدد لاحقاً نوع 


المعلومات التي يحملها كل جزء. 
ET / BTTP/1.1 |‏ 


Connection: Keep-Alive 


6] Accept: image/gif, image/x- 
xbitmap, image/jpeg, 
image/pjpeg, */* 
Accept-Language: en-us 
Accept-Encodina: aziv.,. 


Content-type :application/x- 
www-form-urlencoded 


Content-length:23 


Name=sami&type=3 
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مُعرف (محدد) المصدر / الطريقة 
او 
ترويسة الطلب 


ترويسة الكيان 


جسم الكيان 


يتألف طلب 1۲۲۴ مما يلي: 


يتكون الجزء الأول من طلب 1p‏ من العبار ة »)Method URI H1 P/vers107(‏ الذي يطلب الصفحة من المخدم عبر 
مُعرّف المصدر )0۸R1(‏ باستخدام الطريقة .6٤104‏ يُمثل القسم الباقي من هذا الجزء من الطلب (الجزء 1۲۲۲۴/1.1]) 
نسخة البروتوكول المستخدمة. 

يحتوي الجزء الثاني من الطلب الترويسة العامة ويحدد معلومات عامة كالتاريخ الحالي أو معلومات خاصة كالاتصال الحالي. 
يعد هذا الجزء غير إجباري بحيث يمكن أن يتم إرسال طلب 111۴ من دون هذا الجزء. 

يحتوي الجزء الثالث الذي يدعى ترويسة الطلب على معلومات تتعلق بالزبون مرسل الطلب و بنمط البيانات المرسلة و اسم 
المضيف. يُعد هذا الجزء غير إجباري بحيث يمكن أن يتم إرسال طلب 111۴ من دون هذا الجزء. 

يُستخدم الجزء الرابع الذي يدعى ترويسة الكيانء عند الشروع بإرساله وهو يحتوي معلومات تتعلق بنمط الكيان» وطولهء 
ومصدره و طريقة ترميزه. يكون هذا الجزء غير ضروري في حال عدم إرسال أي كيان. 

يمثل الجزء الأخير جسم الكيان و يحتوي القيم التي يقوم الطلب بإرسالها مثل قيمة حقل ما. 


POST yİ GET طريقة‎ 


بالعودة إلى مخطط الأجزاء المكونة لطلب 1۲۲۴ نجد أنه يحتوي على الطريقة التي سيجري استخدامها في إرسال المعلومات. تأخذ 
هذه الطريقة إحدى القيمتين التاليتين : 


دة ا 0 ار رعا ات الك لى وان الع كد 0 كق 
الترويسة نفسها. 

1 يجري طب اأرفقة المحهة ماقمد 10 ويجري إرسال ياناك الستكم إلى اران الغين بالمضد ااا مع تكمين 
البيانات ضمن الجزء الخاص بجسم الكيان و ليس في أي من الترويسات. 
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تستخدم هاتان الطريقتان أثناء العمل مع نماذج 11× » كما يدعم البروتوکول 1١١۴‏ العديد من الطرق الأخرى ذذكر منها: 


02D‏ : تتقدم بطلب مطابق للطلب الذي تتقدم به 6٤1‏ و لكن الجواب على هذا الطلب يتكون من ترويسة دون أي جسم. تفيد هذه 
الطريقة في الحصول على المعلومات الموجودة في ترويسة الجواب [۲١۴‏ دون الحاجة إلى نقل كامل محتوى الجواب بما في ذلك 
نص الوثيقة التي يجري نقلها عادة عند الإجابة على الطلب. 

۴L٤‏ : تستخدم لحذف الوثيقة المُشار إليها بالمحدد 0۸1 وهي نادرة الاستخدام. 

R٤‏ عند إرسال الطاب تجري إعادة نفس الطاب كاستجابة. بحيت تمكن الزبون من معرقة المعلومات التي تضيفها المخدمات 
الوسيطة إلى الطلب أو معرفة أي تغيير يحصل على محتوى الطلب المرسل. 

۴58 0: تعيد قائمة بطرق 1١۲۴‏ التي يدعمها المخدم ويمكن استخدامها لاختبار عمل مخدم الوب. 


GET yi POST 


عند استخدام GET‏ لإرسال بیانات النموذج من الضروري مراعاة مايلي: 
Problem loading page - Mozilla Firefox ET‏ 


Eila Edl Yim an Bookmarks Tools Help 
َ@ 3 ت چ‎ MM 3 ® ا‎ @ http fw, skin, cafi test, aspx?name=ûhmadjob=manage 
{Ê Getting Started BJ} Latest Headlines 
يجب ألا يكون حجم هذه البيانات كبيراً؛‎ 
يجب ألا تحمل البيانات المُرسلة طابع السرّية.‎ 


تستختم 681 أيضاً بكثرة عندما تمرير قيمة معينة لملف عن طريق ارتباط تشعبي: 


أما الطريقة ۴051 فتستخدم لإرسال بيانات النموذج في حال: 
فال مات بک کر فا 
2 إذا كانت المعلومات التي يتعامل معها النموذج حساسة. 


بعد أن تعرفنا علی الفرق بین إرسال طلب ۳۲۲۴ باستخدام 6٤81‏ و إرسال طلب ۶ 1 باستخدام ۴051» لا بد من توضیح 
سبب استخدام کل من الطريقتين في نماذج :XHTML‏ 


تستخدم الطريقة 681 لإرسال بيانات النموذج: 
عندما لا يكون حجم هذه البيانات كبيراً نظراً لان حجم البيانات الممكن إرسالها محدود بالحجم الأعظمي لمحدد المصدرء أي 
URL‏ 
عندما لا تحمل البيانات المرسلة طابع السرآية لأن هذه البيانات ستكون مكشوفة وستظهر ضمن حيز عنوان المستعرض 
علد رين قيمة سين املف عن طرق ار قاط شي 
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تستخدّم G81‏ بكثرة عند تمرير قيمة معينة لملف عن طريق ارتباط تشعبي. فعلى سبيل المثال» إذا أردنا تمرير القيمة 10=× 
إلى الملف ×مءه.اءع) عند النقر على وصلة ما ولتكن الوصلة ءإعط ءزاع» تكون الصيغة على الشكل التالي: 


أما الطريقة ۴051 فتستخدم لإرسال بيانات النموذج في حال: 
أردنا إرسال بيانات بحجم كبير نسبيا مثل ملف أو مربع نص يحتوي على حجم كبير من البيانات. 


إذا كانت المعلومات التي يتعامل معها النموذج حساسة بحيث لايمكن إظهارها ضمن حيز العنوان في المستعرض. 
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الفصل الثالث والرابع 
التعرف على البيئة 


يتعرف الدارس في هذا الفصل على: 
1. تقانات ا۴موهآءM1‏ المساعدة في تطوير مواقع وتطبيقات الو 
2. بناءِ تطبيق وب باستخدام ASP.NET‏ 
3. طريقة التعامل مع معطيات التطبيق 
4. التعامل مع مدخلات المستخدم ومع الأحداث 


بيأ Microsoft .NET Jal‏ 
تمتلك بيئة العمل ..٤1‏ بنية مكدس مؤلف من عدة طبقات من التقنيات التي تساعد في تطوير تطبيقات الوب أو أي نوع من التطبيقات 
الأخرى. كما تعتمد بيئة .٤1‏ البرمجية على العديد من المكتبات البرمجية (مثل ا٤۷‏ .١1ع‏ اءرS؟ء‏ m.2ataءاورS‏ وغيرها) المكونة 
من آلاف الإجرائيات المكتوبة بلغات مثل C++‏ و #€ و اه8 1ء۷ والمجهزة مسبقاً لتكون قابلة للاستخدام مباشرة. 
توفر بيئة العمل .N E١‏ بالإضافة للتقنيات التقليدية المستخدمة في بناء تطبيقات الوب (سواء كانت من جهة الزبون أو من جهة المخدم) 
تقنيات جديدة أو تقنيات محدثة عن تقنيات سابقة. نذكر بعضاً منها تعداداً على أن نعود إليها بالتفصيل: 


ASP.NET 3.5 

Web Services 

JavaScript 

ASP.NET AJAX 

XML 

Silverlight 

Language Integrated Query (LINQ) 
ADO.NET 


1. 
2. 
3. 
4. 
5. 
6. 
8. 


بناء صفحة وب ڊwlتخدplI ASP.NET‏ 


4 توليد موقع الوب: 
Visual Web Developer 2008 Express Edition Jıiî .1‏ . 
راد موق الوب 
3 الحصول على البيتة البرمجية الازمة ياء تظبيق الوب» 


. إضافة عناصر تكم ASP.NET‏ 
نعرف عناصر التحكم بأنها أغراض تحتوي على رماز يمكن للمتصفح أن يفهمه ويقبله ويفسره عند فتحه للصفحة التي تحتوي هذه 
الأغراض. 
1. لنذهب إلى زر ١عاوء(‏ لعرض صفحة التصميم والتي سيظهر فيها صندوق مظلل بالرمادي ومحاط بخط منقط. يشير هذا 
الخط إلى مقطع مكافئ لتأشير ة <۷نل> في ا۲M].‏ 
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2. اعتباراً من واجهة ×0ط1هه 31 ۷1W‏ اسحب أحد عناصر التحكم إلى داخل المستطيل الذي ذكرناه في الفقرة السابقة 
€. مشاهدة صفحة ضمن المتصفح: 
دكا قاف فة شمن اللتص رهي ف ع ا 3 ل ا6 مخ ر ات فى معاهة اراز عضري 
المكتوب بلغة ۸8۴.6٤‏ وتوليد صفحات M1‏ 11. لتنفيذ ذلك يمكن للمطور : 
1. وضع الفأرة ضمن صفحة ٤ASP.N6؛‏ 
الضغط بالزر اليميني lyختlıر .View in Browser‏ 
إعداد البيئة 


بعد إقلاع البيئةء يحصل المطور على الإعدادت التلقائية التي تقدمها البيئةء ولكن بإمكانه تغيير هذه الإعدادات بسهولة. 


عرض الإعدادات: 
للتأكد من أن الإمكانيات جميعها متاحة: 
0 اختر .To01s3 0pti0ns‏ 
0 في نافذة .Show All Settings رتخl Options‏ 
لإالغاء بعض الإعدادات الخاصة بالمبتدئين والتي تخفي إمكانات متقدمة خاصة بلغات البرمجة: 
اختر sصi0)ا0p‏ 01s3هT.‏ 
في نافذة ئ۸ ام0 افتح llخlر .AlI Languages رتخly Text Editor‏ 
في المنطقة الخاصة ب .Hide Advanced Member Box رlıخJl يغلi Statement Area‏ 


ألغي الخيار 01 UR Nava t1‏ ickاc-ماعSin‏ في أسفل صندوق الخيارات نفسه. 
لجعل الصفحات تقلع اعتباراً :Design View ja‏ 


.To01s23 0pti0ns اختر‎ 
.Show AlI Settings |ختڙ‎ Optio 7s في نافذة‎ 
.HTML Designer > General jتخ|‎ 


lختر .Design View‏ 
إضافة عناصر تحکم باستخدام Toolbox‏ 


سنختار مجموعة من عناصر التحكم الخاصة بتقنيات ×۸[4 لإضافتها كوننا سنستخدمها لاحقاً: 
إذهب إلى llئêynژgع ‘www.codeplex.com/AtlasContro1 Toolkit‏ 
lختر ‘Downloads‏ 
قم بتنزیل للف AJA XContro1Too1kitSource.zip‏ (یمکن تقريل الملف نفسة من المحتوى مباشرة وذون الحاجة 
للذهاب إلى موقع الوب)؛ 
بعد تنزيل الملف قم بفك ضغطه ضمن مجلد ٣1‏ ۸|:]؛ 
إذهب إلى 1٠0180×‏ واضغط بالزر اليميني للفأرة على المنطقة الفارغة التي تلي اداع 8۲21ىم6؛ 
اختر ا14 ۸4 وأدخJ‏ !ؤم Toolkit‏ !AJAXContro1؛‏ 
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اضغط على )اه ٣1هإره٣×۸[4‏ ومن ثم بالزر اليميني على الفراغ الذي يليه واختر كصع)! ١إ‏ A؛‏ 
8. اختر ع80Ws‏ من النافذة التي تظهر واذھب إل مجlد:‏ C\ACT\SampleWebSite\Bin؛‏ 
9. اختر AjaxContro1T'oolkit.d11‏ واضغط .٥⁄&‏ 
ستظهر عناصر التحكم المطلوبة بشكل مختار يكفي الضغط على 0K‏ لتظهھر تحٽ .AJAXContro1 Toolkit‏ 


التعامل مع واجهة التطوير الأساسية 


فيما يلي بعض أساليب التعامل مع واجهة التطوير التي تدع .Solution Explorer‏ 


تنظيم الملفات في Solution Explorer‏ 
يعتبر 10۲۴۲م×۴ S0110٥۸١‏ المكان الذي يجري فيه إضافة وتجميع الملفات الخاصة بتطبيق الوب. يمكن استخدام خاصة 
Drag Drop‏ بين 0luti0n Explorer‏ وبین نظام ملفات sس0لمW1‏ لنقل ملفات من هذا الأخير باتجاه Solut101‏ 
.Explorer‏ 
فعلى سبيل المثال» يمكن بالنقر بالزر اليميني على ٥ه"‏ ٤٥ء٥۴‏ (یدعی تلقائياً Add New Item رlıتخly (WebSite1‏ İنù‏ 
تظهر لنا مجموعة الملفات التي يمكن اضافتها. ویمکن عندھا اختیار ×M1 ۴1e‏ بحیٿ تظھر ضمن ۲٤10۲م×٤‏ 0۸ S01 uti‏ حیث 
يمكن استخدامها في عملية التطوير البرمجي في حال كانت هناك حاجة لوجودها. 


استخدام نوافذ وواجهات 'الخصائص": 
يتعامل المطور الذي يستخدم البيئة مع نافذة معممة على مختلف العناصر والتي تدعى نافذة الخصائص (1۴5٤۲ءم٠۴).‏ تكون هذه 
النافذة عادة مهمة جداً لإعطاء عناصر التحكم خصائص مختلفة تتناسب ونمط التطبيق المطور. فعلى سبيل المثال: 

إذهب إلى صفحة ۷1W‏ «عاوهD‏ من الصفحة التي قمت بتوليدها. 

اختر من ×0 ط1٥٥‏ عنصر التحکم Button‏ من فئة S18١24۲4‏ وأنقله إلى الصفحة. 

اضغط بالزر اليميني للفأرة على العنصر ١٥)ا»8‏ واختر ك1#٤#۲مهإ۴.‏ ستظهر في أسفل النافذة من ناحية اليمين خصائص 

هذا العنصر. 

يمكن بالضغط على أيقونة الترتيب الأبجدي في نفس مقطع #۲۲٥5‏ م٠۴۲‏ أن نرتب الخصائص ترتيباً أبجدياً. 

بالذهاب إلى الخاصة 10 يمكن تغيير قيمتها إلى أم٠ءء4‏ 1ط مثلاً واختيار لون بالنسبة للزر والخط وغيره. 

بالذهاب إلى زر ءءإںه؟ المجاولر لزر سع ا۷ «ع1وء( سيظهر الرماز الذي تم توليده بعد تغيير الخصائص 


بناء موقع ASP.NET‏ 


سنقوم فيما يلي بتوليد موقع بسيط يتعامل مع جدول ضمن قاعدة معطیات :5Q1 8۲۷٥۲‏ 


توليد الموقع: 

File New Web Site jتخ|‎ 

عند ظھور مربع الاختيار |ختر ‘Empty Web Site‏ 
حدد مکان لتخزینه (مٿل e65)‏ 5:1|MyW)؛‏ 
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يمكن اختيار لغة التطوير C#‏ أو یج8 .V¡sua1‏ 
بهذا يكون لدينا موقع فارغ تماما ويمكننا البناء اعتبارأ منه. 


:SQL Server Express Database plدختul‎ 

اضغط بالزر اليميني على الموقع واختر New Item‏ Add؛‏ 

‘SQL Database |ختر‎ 

ضع الإسم الذي تختار ه لقاعدة المعطيات My WebSite)‏ مثا ؛ 

سيقوم بتوليد المجلد 314_مم۸ ووضع القاعدة ضمنه. 

.Database Explorer زر‎ My WebSite. df بالضغط ضغطتين على‎ 

بالضغط بالزر اليميني على ءع1طه٠‏ واختيار ٥1ا1‏ ل۸ ستظهر واجهة تسمح بإضافة حقول للجدول وبإضافة الجدول 
ومفاتیحه وفقا لخيارات المطور. 

بالذهاب إلى ۸11 ۴11۴384۷ سيطلب منك النظام تسمية الجدول لحفظه. 

إضغط بالزر اليميني على الجدول واختر 24ل س0!؟. 

بالذهاب إلى النافذة اليسارية يمكنك ملئ الجدول. 

اضغط بالزر اليميني على الموقع واختر New Item‏ Add؛‏ 

؛Default.aspx‎ رqظتwn‎ Web Form اختر‎ 

بعملية و50 & 4إ( خذ الجدول الذي قمت ببناؤه وأنقله إلى مقطع ۷ال الموجود في الصفحة ×مءه.٤ااة؟٥0.‏ سيتم 
يمكنك الآن عرضه عبر الضغط بالزر اليميني على الصفحة وlختlıر .Show in Browser‏ 


التعامل مع المعطيات وإدارتها ومعالجتها 


سنستعرض في هذه الفقرة طريقة توليد وبتاء قاعدة معطيات مرتبطة بتطبيق وب وطريقة التعامل مع مكونات هذه القاعدة. عموما 
نحتاج لتأمين العمليات الأساسية التالية عند التعامل مع قاعدة معطيات: 
إضافة معطيات إلى القاعدة؛ 


البحث عن معطيات موجودة ضمن القاعدة؛ 
تحديث معطيات ضمن القاعدة؛ 
حذف معطيات من القاعدة. 
يمكن إضافة عمليات أخرى خاصة بالتطبيق الذي يتعامل مع قاعدة المعطيات وبحيث نجعل هذا التطبيق : 
يقدم المعطيات بشكل جذاب وأنيق؛ 


يحسن من زمن جلب المعلومات وعرضها على الشاشة: 


Smart Tags التعرف علذى‎ 

تمتلك عناصر تحكم ۸8۴.٤1‏ المتقدمة مثل العنصر ۷1W‏ 11ا6 أدوات مساعدة على تصميمها ندعوها ١6۲”ع1وه2.‏ تتمثل هذه 
الأدوات بمجموعة من الإجرائيات التي تساعد على إعداد هذه العناصر وفق خيارات متعددة. تظهر معظم أدوات التصميم عند استدعاء 
الواجهة 128 51021 وهي لوحة من الإجرائيات المساعدة على تصميم عنصر التحكم. 
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للوصول إلى هذه الواجهة يكفي إزاحة عنصر تحكم (زر من الأزرار) اعتبارا من ×0ط01٥1‏ ومن ثم الضغط بالزر اليميني عليه 
وتأشير .Show Smart ag‏ 


تحسين عنصر llتھحكp Grid View‏ 
يمثل عنصر التحكم 1٥W‏ 14۷إ6 واجهة للتعامل مع المعطيات الموجودة في القاعدة (الترتيب» الاختيارء العرض) ويعتبر من عناصر 
التحكم المهمة والفاعلة التي سنستعرضها بالتفصيل لاحقاً. في هذه المرحلة سنضع العنصر 6۲14۷1W‏ على صفحة الوب ونقوم بتنفيذ 
بعض الإعدادات عليه: 

اختر عنصر التحكم س1 4۷ا6 من مجموعة الأدوات 4ة واضغط بالزر اليميني على زر ع14 .81١2۲١‏ 

اختر t0 ۴١۲٣۳١۵۲‏ ۸. تعرض هذه النافذة ال يحدصعطء؟ المتوفرة. لنختر (Professional)‏ مقلا. 

اختر مصدر المعطيات (ع٥uهS )0٤4‏ ولیکن فشا بقاعدة المعطيات التي سبق وولدناها. 

يمكنك الآن اختيار ... ,ع«أعه۴ ,ع«ذاإه؟ والتي ستسمح بترتيب الأسطر ضمن ۲11۷1Wإ6‏ وتوزيع المعطيات على 

صفحات» والقيام بعملية اختيار لسطر من أسطر ال إأاإ6. 

يمكن الآن وبعد العرض بالمتصفح أن نختار سطراً بالضغط على tء1#م؟.‏ 

يمكن أيضاً أن نرتب وفق الترتيب الأبجدي في العمود ۴1۲١۲ N.4۳‏ بالضغط عليه. 

إذهب إلى ع12 S21٤‏ وأضغط على Edit Columns‏ ومن م |ختر .Selected Fields‏ 

يمكنك الآن تغيير إعدادت الإظهار مثلا الخاصة بحقل من حقول الجدول (لون الخلفية وغيره). 


Fon View عنصر التحکم‎ 

يساعد عنصر التحكم Wء ۴٥۲٠0۷1‏ في توليد المعطيات. لتنفيذ ذلك. 

1. اختر عنصر التحكم Form View‏ من مجموعة الأدوات واه واسحبه إلى أسفل ۷1ew‏ )1اG.‏ 

2. اختر مصدر المعطيات (١٠إ»ه؟ )01a‏ وليكن متمثلاً بقاعدة المعطيات التي اخترنا التعامل معها في س14۷1#إ6. 
3. تساعد ۴٥۲٣۵۷1٤ W‏ على إضافة عملیات ھلم ,۲۲٥ء1‏ ... وغیرھا اعتبار ا من الواجهات eھام‏ ہ۲ . 


تثبيت عنوان الصفحة 

4. بالذهاب إلى ۷1W‏ معاوه والضغط بالزر اليميني للفأرة على المساحة البیضاء واختیار ۶٥1٤#۲م٥إ۴‏ يمكن الذهاب إلى 
المربع اليميني الذي يحتوي على الخصائص عنوان الصفحة إلى ”0ء٣٠۴‏ مثلا. سيظهر عنوان الصفحة في أعلى المتصفح 
عند استعراضlq‏ ڊwlتخدpl View in Browser‏ . 


التعامل مع الأحداث ومع إدخلات المستثمر 


يمكن استخدام عنصر التحكم ٠١×180×‏ يأنواعه لإدخال المعلومات. كما يمكن استخدام عنصر التحكم ۸441080١‏ لخيار وحيد. 
واستخدام عنصر التحكم ×0 8ءمطC‏ لخيارات متعددة. كمثال سنقوم بإعداد تهيئة لا ئحة خيارات: 
0 اسحب عنصر التحكم 1عطه.1 إلى الصفحة وأسند القيمة م٥11۴‏ للخاصة (Rate Your Fear ةnيقلl دنسأİو 1D‏ 
Text ةصاخll of the Borg)‏ . 
اسحب عنصر التحكم RadioButton 1st‏ إلى الصفحة وأسند القيمة ع180 للخاصة 10. 
أضف عنصر 61طه1 آخر مع إسناد القيمة #ك«0مء 118 للخاصة 150. 
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أضف عنصر ہBufto0.‏ 

اضغط على ع4٠‏ 5021۲ الخاصة بالعنصر Rad108u†)0 11s‏ واختر ئ"ه6 81٤1)‏ لإضافة لائحة من الخيارات. 
للحصول على نتيجة الخيارات التي سيستخدمها المستخدم» يمكن بالضغط المزدوج على الصفحة الفارغة فتح 
الصفحة الخاصة بالإجرائيات المرتبطة باللائحة. أضف ضمن الإجرائية 1024_معه۴ التعليمة: 


.IbIResponse.Text=rbl]Borg.Selected Value 
ان يمكن اعتار ا من مجموعة المعطيات ولائحة الخيارات التي أضفناها أن نحصل صفحة بالمتصفح حسب ما يظهر في الشكل.‎ 
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الفصل الخامس و السادس 
أساسيات نماذج الوب 


يتعرف الدارس في هذا الفصل على : 
1. مفهوم تطبیقات وب 
. بنية المجلدات في مشرو ع ۸5۲.۸۴٤۲‏ 
. أنواع الملفات الأساسية التي تتعامJ‏ معlq ASP.NET‏ 
. عناصر تحكم 11M‏ من طرف المخدم 
. أحداث عناصر تحكم 11M‏ من جهة المخدم 
. الصفوف القاعدية لعناصر التحكم » خواصها والأحداث التي تطلقها 
. ملفات ×هيه.1هطهاع و أحداث التطبيق 
. الإعدادات في تطبيتlاٽت web.config «machine.config ٽlln, ASP.NET‏ 


مفهوم تطبيقات الوب 


يصعب في بعض الأحيان تحديد ماهية تطبيق الوب و حدوده بعكس ما هو في التطبيقات التقليدية (التي يمكن إطلاقها بتشغيل ملف 
تتكون تطبيقات الوب من مجموعة من صفحات الوب. نتيجة لهذا التقسيم إلى صفحات» يمكن للمستخدم أن يدخل إلى التطبيق من عدة 
صفحات» كما يمكنه أن ينتقل من صفحة إلى أخرى من خلال الضغط على وصلة ()«ناءمر1]). كما يمكنه في بعض الأحيان» أن 
ينثقل من مخدم وب إلى مخدم آخر من خلال الضغط على وصلة. لذا يكون السؤال المطروح عادة: ما هي حدود تطبيقات الوب. 


تشترك جميع الصفحات في تطبيق N.٤1‏ .۸58۴ بمجموعة من الموارد )۸e801۲٥88(‏ وبمجموعة من الإعدادات 
.)€0nfigurat1005(‏ تكون مجمو عة الموارد والإعدادات مخصصة لتطبيق دون آخر حتى ولو كان التطبيق الآخر موجود على نفس 
المخدم. إذ يتم عزل كل تطبيق ضمن ما يسمى نطاق التطبيق (01١21١(‏ ١٥1اةءاممA)‏ ويكون هذا العزل على مستوى الذاكرة 
والمعالجةء ومعلومات الجلسات» والذاكرة الخبيئة. نتيجة لذلك» يتم تعريف نطاق تطبيق الوب بأنه مجموعة الصفحات و الوحدات 
والمقابض (5١۲ء1ل١4ط)‏ التي يمكن الوصول إليها من خلال مجلد افتراضي على مخدم الوب (أو من خلال المجلدات الفرعية 
الموجودة ضمن المجلد الأفتراضي الأساسي وتبعاً للسماحيات المختارة). 
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(Application Domain) نطاق التطبيق‎ (Application Domai) نطاق التطبيق‎ 
ملفات التشكيل ( صفحات الوب ملفات التشكيل ( صفحات الوب‎ 
Web pages Configuration files Web pages Configuration files 


بيانات كائنات التطبيق 4 خدمات الوب بيانات كائنات التطبيق 4 خدمات الوب 
والجلسات Web services‏ والجلسات Web services‏ 
Application and Application and‏ 

sessions data sessions data 


(Application Domain) قيبطkتئا نطاق‎ (Application Domain) Jيبطتلئا نطاق‎ 


ملفات التشكيل صفحات الوب ملفات التشكيل صفحات الوب 
Web pages Configuration files Web pages Configuration files‏ 


ک 


N 
بيانات كائنات التطبيق خدمات الوب بيانات كائنات التطبيق 4 خدمات الوب‎ 
Web services والجلسات‎ Web services والجلسات‎ 
Application and Application and 
sessions data sessions data 


8 8 


أنواع الملفات في :۸8۲.N ٤‏ 


الضف 
هذه اللاحقة خاصة بصفحات الوب في .۸8۲.N ٤۲‏ 

تحتوي تعبيرات لغة التأشير التي تحدد تصميم واجهة المستخدم. 

قد تحتوي هذه الصفحات رماز التطبيق الذي يتم حصره ضمن وسم <SCRIPT‏ 
runat="server"></SCRIPT>‏ 

تستخدم هذه اللاحقة مع ملفات عناصر التحكم الخاصة بالمستخدم . هذه الصفحات مشابهة لسابقاتها إلا فيما 
يتعلق بإمكانية الوصول إليها مباشرة. 

لاستخدام هذه العناصر لا بد من استضافتها ضمن صفحة أخرى . تمكن هذه العناصر من تصميم قطع من 
واجهة المستخدم قابلة لإعادة الاستخدام. 


تمثل الملفات التي تستخدم هذه اللاحقة مجموعات الطرق الخاصة بخدمات الوب. 

يمكن استدعاء هذه الطرق عبر الانترنت . 

تعمل خدمات الوب بشكل مختلف عن صفحات الوب لكنها تشترك معها في الموارد و الإعدادات 
(nfigurati00د)‏ و الذاكرة الخاصة بالتطبيق. 

. XML نيق‎ web.config يستخدم ملف‎ Web.config 

تم تخصيص هذا الملف في ۸5۴.٤۲‏ لإعداد التطبيق. 

يتضمن هذا الملف إعدادات خاصة بأمن التطبيق » إدارة الحالة › إدارة الذاكرة و غير ذلك. 
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Global.asax‏ هذا الملف هو الملف العام للتطبيق. 

يتم استخدام هذا الملف لتعريف المتحولات العامة » حيث أن هذه المتحولات تكون متاحة لأي صفحة ضمن 
تطبيق الوب كما يمكن استخدام هذا الملف لتعريف طرق مقابض الأحداث (إ1e e٣٤ 12٣d‏ vع٤)‏ العامة 
كالطريقة الخاصة بمقبض حدث بدء تشغيل التطبيق . 

تستخدم هذه اللاحقة مع الملفات الحاوية على الرماز في الخلفية background code)‏ . 

تمكن هذه الملفات في ۸8۴.٤1‏ من فصل منطق التطبيق عن واجهة المستخدم في صفحة الوب. 


ما يمكن لتطبيق ۸5۴.٤1‏ أن يحوي أنواع الملفات المعروفة مثل 088. أو ا 1۲. أو أنواع ملفات الصور مثل .[P6‏ أو 61۴. 


المجلدات الأساسية ضمن تطبيق ۲.۸.٤1‏ S؟۸:‏ 


عادة ما يتم التركيز على مجموعة من الممارسات التي تساعد على بناء تطبيق وب ناجح . من أهم هذه الممارسات مراعاة استخدام 
هيكلية مجلدات مناسبة ضمن التطبيق . 
الجدول التالي يوضح بعض هيكلية و عمل المجلدات التي تقوم بيئة تطوير 0الناء 21ء۷ بإنشاءها ضمن مجلد التطبيق حسب 


الحاجة: 
المجلد 
Bin‏ 


App_Code 


App_GlobalResources 
App_LocalResources 
App_WebReferences 

App_Data 


App_Themes 


الوصف 
يحتوي هذا المجلد على جميع مكونات .NE1‏ المترجمة (مكتبات الربط الديناميكي 011( التي 
يتم استخدامها من قبل التطبيق إضافة إلى المكونات المخصصة التي يضيفها المستخدم . 

تقوم ۸8۴.٤1‏ باكتشاف المكونات االمجمعة و تمكن أي صفحة وب ضمن التطبيق من 
استخدامها . 

توفر هذه الطريقة سهولة كبيرة مقارنة مع العمل مع مكونات 00۷M‏ التي تستلزم تسجيل المكون 
قبل استخدامه. 

بتري هذا الفاة اأزمار المضكري الأ ك تر جه داكا الاك اة من القطيق يري 
هذا المجلد الرماز المصدري و ليس الملفات المجمعة كما هو الحال في )81١‏ 

تستخدم لتخزين الموارد العامة المتاحة لجميع الصفحات ضمن التطبيق . 

يشبه هذا المجلد المجلد السابق بفرق كون الملفات متاحة لصفحة محددة 

يستخدم هذا المجلد لتخزين مراجع لخدمات الوب المستعملة من قبل التطبيق. 

يستخدم هذا المجلد لتخزین البیانات بما یتضمن قواعد بیانات 2005 یی٤!م×٤ 8Q1‏ و ملفات 
XML‏ 

يستخدم لتخزين السمات التي يستخدمها التطبيق. 
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مقدمة إلى عناصر التحكم من جهة المخدم: 


طرحت ۸8۴.٤1‏ مفهوماً جديداً قي إنشاء صفحات الوب. يستخدم هذا النموذج عناصر التحكم من جهة المخدم. 
يتم إنشاء هذه العناصر و تشكيلها كأغراض » تعمل هذه الأغراض على المخدم . 
تقوم هذه الأغراض بتوليد خرج 11۷1 الخاص بها. 
تعمل هذه العناصر بشكل مشابه لمثيلاتها في تطبيقات ءسهلہ1 العادية من حيث قدرتها على الحفاظ على الحالة و إطلاق الأحداث 
التي يمكن معالجتها ضمن الرماز. 
توفر ۸8۴.٤1‏ مجموعتين أساسيتين من عناصر التحكم من جهة المخدم: 
ه٠‏ عناصر تحكم ]11۷ من جهة المخدم: و هي المقابلات لتأشيرات ا١١[‏ القياسية و لكن من جهة المخدم. تعتبر 
عناصر التحكم هذه مثالية لمبرمجي الوب الذين يفضلون العمل على تأشيرات ا11۷1 المألوفة لديهم. كما أن عناصر 
التحكم هذه مناسبة لأولئك الذين يريدون الانتقال من تطوير صفحات ۸8۴ إلى تطوير صفحات ASP.NET‏ 
كونها لا تتطلب قدر كبير من التغيير عما تعوده المطورون الذين تعودوا العمل باستخدام ۸8۴ . 
لعناصر تحكم 111 من جهة المخدم ثلاث ميزات أساسية: 
1. تقوم هذه العناصر بتوليد واجهتها الخاصة 
2. تحتفظ هذه العناصر بمعلومات الحالة 
3. تقوم عناصر التحكم هذه بإطلاق الأحداث من جهة المخدم 


عناصر تحكم الوب: تشابه هذه العناصر عناصر 11۷1 من جهة المخدم بشكل كبير ولكنها توفر: 

1. نموذج غرضي أكثر غنى» من حيث تنوع الخصائص و تفاصيل التنسيق و الأنماط 

2 أحداث أكثر 

3 بيئة تطوير أقرب إلى تلك المستخدمة في تطوير تطبيقات ws‏ 0لاس مثل عناصر View‏ 6۲14 و 
n1‏ اCa‏ و عناصر التحقق من الصحة. 


عناصر تحكم ۲۷11[ من جهة المخدم: 


:ASP.NET ةحiص‎ ylإ‎ HTML تحويل صفح‎ 


سنحاول في هذا الجزء من الجلسة استخدام مثال للوصول إلى فهم أكبر لعناصر تحكم ا1[ من جهة المخدم. 
يُظهر الشكل رقم (2ءإ٠ع۴1)‏ واجهة صفحة وب خاصة بتطبيق تحويل عملة من الدولار إلى مقابلتها باليورو. 
التطبيق في هذه المرحلة هو مجرد واجهة » تمت صياغتها بتأشيرات ا11۷ قياسية و لن تتسبب عملية نقر الزر 0 أية استجابة. 
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3 Currency Converter - Mlerosoll Inter nel Explorer 
EE Eft Yew Famrits Tons eb Qk ° O ` A A 
AfHess 3 hetp:fllecalhast:2040/ChaptETS [Currercr Cony er ter. asp: 


Zofwerk: U.S. dollars ta Efûs 
24) 


6 ادد‎ ihraneh 


فیما يلي نص HTML‏ القياسي لهذه الصفحة: 


CI BDOCTYPE KENL PUBLIC ZV IRICIIDTD ITM I-17 
HEEB MS OLO ME REMI L DID /XNEMLILL AES 
CREM xXMINS NEL: WU .OEG/ 199 xREML 
<head> 

<title>Currency Converter</title> 

</head> 

Body 

<EOEM method "posl"z 

Si 

Convert: &nbsp; 

<input Ltype T"iexl" /> 

ERnSSB7 U.S: dolla SS CO EUS. 

BE JB 7. 

<input type="submit" value="OK" /> 

cO 

EEL 

</body> 

lS 


إن أسهل طريقة لتحويل هذه الصفحة إلى صفحة ۸8۴.٤1‏ هي بتوليد نموذج وب جديد باختيار: 


Websites > Add New Item 


ثم اختیار Web ۴٥۲۳‏ و تحدید اسم لصح CurrencyConverter.aspx Î‏ 

تأكد من تفعيل خيار فصل الرماز في ملف مستقل ثم اضغط ل۸ لإنشاء الصفحة. 

قم بحذف جميع محتويات الصفحة عدا موجه <%ءp2g@®@%>‏ . 

يزود هذا الموجه ۸8۴.٤1‏ بالمعلومات الأساسية عن كيفية ترجمة الصفحة » اللغة المستخدمة و طريقة الوصول إلى 
مقابض الأحداث و موقع ملف الرماز العامل في خلفية الصفحة. 

قم بنسخ محتوى ملف ۲۷1[ إلى الصفحة الجديدة مباشرة بعد تأشيرة الموجه #ع۴a‏ . 
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ما يزال النموذج حتى هذه المرحلة غير عامل » ولا بد لنا لجعله يعمل من إضافة الواصفة "٠ءء‏ "اهس إلى جميع التأشيرات 
التي نرغب بتحويلها إلى عناصر تحكم من جهة المخدم» كما لابد من إضافة الواصفة (1 إلى جميع هذه العناصر. 

مک اقا سے اضر اتك اكد القع هرد ايخ مخ ى ار اة 16 و اي سخ اتتام رخ لى عار 
التحكم تلك. 


<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="CurrencyConverter.aspx.cs"™" Inherits="CurrencyConverter"™" %> 
BEML xXMINS NEED: WWW. OEIC 

<head> 

<title>Currency Converter</title> 

</head> 

Bod 

<form runat="server"> 

CEO 
Convert: &“nbsp; 

<input type="text" ID="US" runat="server" /> 

CASS, USS OdoOLLEES ES CUES. 

BE <br 

<input type="submit" value="OK" ID="Convert" runat="server" 
OnServerClick="Convert_ ServerClick" /> 

<br />5<Br /> 
<div Slyle "font weilght: Bold" IBD "Resulll rUNnaE "Server" </div> 
O 

THOM 

Bod 

REMZ 


صفوف عناصر تحكم ]11۷ من طرف المخدم: 


eنصر HTML‏ 
HtmlTextArea‏ <8×4۲۴4> | علبة نصية ن ة لإدخال نص متعدد 
الأسطر. 

<input type="image"> HtmlInputImage‏ مشابه لعنصر <ع ۳> ولکن یمکن إدراج 
صورة يمكن النقر عليها لإرسال 
النموذج. 

<input type="file"> HtmlInputFile‏ علبة تضبة و زز م لعملية اختيار 
ملف لتحميله على مخدم الوب. 
<input type="hidden"> HtmlInputHidden‏ يقوم باحتواء معلومات نصية ليتم إرسالها 
دون أن تكون مرئية على النموذج. 


Html1Select‏ حا 8618> قائمة منسدلة أو قائمة عادية تحتوي 


C 
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HtmlHead and HtmlTitle 


HtmlGenericControl 


<head> and <title> 


Any other HTML element. 


مجموعة عناصر و تمكن اختيار عنصر 
أو أكثر من المجموعة. 

تمثل معلومات الترويسة التي تتضمن 
بيانات عن الصفحة . 

معظم هذه البيانات لا يتم إظهارها. هذه 
العناصر هي الوحيدة التي لا يتم وضعها 
ضمن تأشير ة عنصر التحكم <۵ إهf>‏ 
عنصر التحكم هذا يمثل مجموعة من 
عناصر ا1۲ التي لیس لها صفوف 
خاصة بها فمثلا إذا قمنا بإضافة الواصفة 
runat="server"‏ إلى تأشير ة >div<‏ 
سيتم استخدام الصف 
Htm]GenericControl‏ للتعامل مع 
عنصر تحکم M[‏ ۲1 الناتج. 


يمتلك كل من هذه الصفوف مجموعة من الخصائص من أهمها التالية: 


HtmlAnchor 


HtmlImage 


HtmlInputCheckBox and HtmlInputRadioButton 
Value 

Value 

Src, Alt, Align, Border 

Items (collection) 

InnerText and InnerHtml 


الخصاتض الكامة 
HRef, Name, Target, Title‏ 


Src, Alt, Align, Border, Width, Height 


Checked 
HtmlInputText 
HtmlTextArea 
HtmlInputlmage 
HtmlISelect 
HtmlGenericControl 


إضافة الرماز الخاص بتطبيق تحويل العملات: 


لبث الحياة في تطبيقنا لا بد من إضافة عبارات رماز ۸5۴.٤1‏ إلى مقابض الأحداث (5إeالم‏ ة8 ٤٣م۷ع)‏ لأن نماذج الوب في 


8P. NE‏ موجهة بالأحداث بمعنی أن كل جزء من الرماز يتم تنفيذه تجاوباً مع حدث معين. 

الحدث الأهم في مثالنا هو الضغط على زر (٤نصطس؟)‏ » حيث يوفر عنصر التحكم 0۸ »اu8مم1اM 1X1"‏ إمكانية الاستجابة لحدث 
النقر على الزر ء11٣۷۲٥8‏ من طرف المخدم. 
يتم استخدام التأشيرة <۷أل> لإدراج نتيجة التحويل كما هو موضح ضمن الرماز التالي: 


mventWireup="true" 


O O 
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CodeFile="CurrencyConverter.aspx.cs" Inherits="CurrencyConverter"™" %> 
CTEM xXMINS NEED: UU WM. OES 1 xR 

<head> 

<title>Currency Converter</title> 

</head> 

Bod? 

<form runat="server"> 

CE 
CORVEEL: SERBS; 

<input type="text" ID="US" runat="server" /> 

ERS; U.S. dollars EO Euros. 

Br /5<bBE /> 

<input type="submit" value="OK" ID="Convert" runat="server" 
OnServerClick="Convert_ServerClick" /> 

<br /><brE /> 
diy SEulE EONE weil: COL IC Rell EUNICE E CIZ 
CO 

RM 

</body> 

CML 


أما الرماز العامل في الخلفية فيتم تخزينه ضمن الملف :CurrencyConyerter.«5p)x.c5S‏ 


using System; 

using System.Web; 
using System.Web.UI; 
using System.Web.UI1I.WebControls; 

USING SVSEEM. WEB. UL. UCMICONEEOLS?; 

public partial class CurrencyConverter : System.Web.UI.Page 
1 
DESLE EEA ONY COnvert SEeruELCLlIISK (ODIECE Seder, EVENIAEIS €) 
1 
decimal USAmount = Decimal.Parse (US.Value); 

decimal euroAmount = USAmount * 0.85M; 

REéESUlItE.THRErText = USAMGOUNTE:TOSEFING(), #* °" U... dollars 
RESUlT. Inner LleExXL ¥ EUEOANOUNL.IOSLEING() F€ F€ EUroSi; 
} 

} 


يبدا ملف الرماز العامل في الخلفيةءكما نلاحظء بمجموعة من التصريحات الخاصة بتأمين الوصول إلى فضاءات الأسماء التي يحتاجها 
التطبيق. 

يتم تعريف صف الصفحة بالكلمة المفتاحية 1ه1٤۲ه۴‏ لأن رماز الصف هو عبارة عن دمج للرماز الذي قمنا بكتابته مع رماز إضافي 
(مخفي) تولده ۸8۴.۴1 أوتوماتیكیاً. 

يعرف الرماز الذي تولده ۸8۴.۴1 جميع عناصر التحكم التي يتم استخدامها ضمن الصفحة مما يمكن الوصول لهذه العناصر بشكل 
مباشر من خلال اسمها. 

يتم في مثالنا تعريف مقبض أحداث وحيدء يقوم هذا المقبض باسترجاع القيمة من العلبة النصية » تحويلها إلى قيمة رقمية ثم ضربها 


بنسبة تحويل محددة. 
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نلاحظ أن مقبض الحدث يقبل قيمتين لغرضين هما الغرض ٥١‏ ل1٥8‏ و الغرض .٠‏ 

تسمح هذه الأغراض للرماز بالتعرف على عنصر التحكم الذي أرسل الحدث (عبر الغرض ١٥ل١56)‏ و الاستحصال على جميع 
المطر مات المرفطة الكت (عر الكركن): 

يتم تحديد اسم مقبض الحدث لعنصر التحكم عبر الواصفة )ءنا٣۲ء۷إمSم0‏ ضمن التأشيرة <اام,ذ> الخاصة بالزر. 


ملاحظة: تختلف عناصر تحكم ا11 من جهة المخدم عن عناصر تحكم الوب .حيث لا توفر الأولى إمكانية إنشاء مقابض الأحداث 
باستخدام نافذة ا۲عم۴ في بيئة التطوير بل يجب كتابتها يدو ا كذلك هي الحال بالنسبة لتعديل قيمة iلواlصفة OnServerClick‏ 
بما يوافق اسم المقبض المستخدم. 


معالجة الأحداث: 


عندما يقوم المستخدم بالنقر على زر 00١۷٥۲١‏ سيتم إرسال الصفحة إلى مخدم الوب عندها تحدد ۸5۴.۴۲ الرماز الواجب تشغيله 
من خلال قیمة |لواصفة OnServerClick‏ 


3 Currency Converter - Microsoft Internet Explorer 
Edit View Favorites Tools Help Qsak ” © ` A A 


Address 3 http: localhost; 2040/Chapter0S/CurrencyConyerter , aspx 


Convert: [275 U.S. dollars to Euros. 


275 U.S. dollars = 233.75 Euros. 


تستخدم ۸8۶.٤1‏ الصيغة السابقة لربط أي مقبض حدث خاص بتأشيرة عنصر التحكم »حيث يتم استعمال اسم الحدث موقا 
بالكلمة 010. 


إذا أردنا مثلاً معالجة الحدث المسمى #ع«ة $۷٠۲٣‏ نقوم باسناد قيمة تعبر عن اسم الطريقة التي ستقوم بمعالجة الحدث إلى 


الو اصiة 0nServerChange‏ ضمن تأشير ة عنصر التحكم. 


ملاحظة: يمكننا هنا أن نفهم سبب الخطاً متكرر الحدوث المتمثل بظهور رسالة خطاً عندما نقوم بحذف نص الرماز المولد آلياً والخاص 
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بمقبض الحدث الناتج عن النقر المزدوج على عنصر التحكم. 
ينتج هذا الخطاً عن توليد واصفة ضمن تأشيرة العنصر الذي تم النقر المزدوج و ربط الحدث بنص مقبض الحدث . 
لحل المشكلة يكفي إزالة هذه الواصفة من تأشيرة عنصر التحكم. 


ملاحظة: لا يتطلب غرض الصفحة في ۸8۴.٤1‏ عملية الربط بالأحداث. 
يتم في غرض الصفحة ربط الأحداث ذات الأسماء المحددة مسبقا تلقائياً في حال استخدمت الاسم الصحيح و عدد المعاملات الصحيح. 


تسمى هذه الخاصة الربط الآلي للأڈحدائ)wireup .(Automatic event‏ 


تسمح ۸8۴.٤1‏ باستخدام تقنية أخرى لربط الأحداث و ذلك عبر النص البرمجي إذ يمكننا متلا إضافة النص البرمجي التالي إلى 
مقبض الحدٿث 10240ء۴Pag:‏ 


ملاحظة: قد لا يكون ربط الأحداث يدوياً مهما إلا في بعض الحالات .من أهم هذه الحالة حالة إضافة عناصر تحكم بشكل ديناميكي في 
زمن التشغيل إلى الصفحة. 
ما الذي يحدث خلف الكواليس في مثال محول العملة: 
. يتم إرسال طلب الصفحة إلى مخدم الوب (يكون هذا المخدم غالبا 188 في حال العمل ضمن بيئة استثمار حقيقية). 
. يقوم مخدم الوب بتحديد كون اللاحقة ×۸8۴ مسجلة لتم معالجتھا عبر ۴۲ .۸8۲۴.N‏ 
. يتم تمرير الطلب إلى الإجراء العامل من ۸8۶.٤‏ (لن تتدخل ۸8۴.٤1‏ في حال كانت اللاحقة هي م5ه. أوملفات 
(.html‏ 
. عند استدعاء صفحة ما من هذا التطبيق لأول مرة تقوم ۸8۶.٤1‏ بخلق نطاق للتطبيق و تترجم رماز صفحة الوب 
لضمان أداء أمثلي كما تقوم بتخزين الملفات المترجمة ضمن المجلد: 
c:\Windows\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files.‏ 


. في حال استدعاء أية صفحة تمت ترجمتها مسبقاً تقوم ۸8۴.٤1‏ بإعادة استخدام النسخة المترجمة من الصفحة. 

. عندما انتهاء تنفيذ الرماز تقوم ۸8۴.۴۲ بالطلب من كل عنصر تحكم أن يقوم بتصيير نفسه (إضافة تأشيرات إلى الخرج) 
إلى تأشيرات 11۷1 المناسبة. 
ملاحطة : تضيف ۸5۶.٤۲‏ أحيانا ءأثاء تصيير عناصر التحكم» نصوص لغة خطاطية من جهة الزبون مثل 
JavaScript‏ أَر DH1ML‏ إذا تحققت من دعم المستعرض لھا. 


. يتم إرسال الصفحة المتشكلة (كناتج خرج لتصيير عناصر التحكم و خرج (۸5۴.٤1‏ إلى الزبون و يتم إنهاء التطبيق. 
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فيما يلي مخطط يوضح المراحل المختلفة لتنفيذ طلب صفحة وب. 


معالجة الطلب داخليا أو 
تمريره إلى خدمة أخرى 


ASP.NET 


التي يحويها 


الصفحة ويتم تحرير غرض الصفحة من الذاكرة. 
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معالجة الأخطاء: 


يتوقع التطبيق» في مثالنا (محول العملة) » من المستخدم إدخال رقم قبل ضغط زر .001۷٥۲۲‏ ولكن ماذا لو ضغط المستخدم زر 
٣ص‏ قبل إدخال أي رقم؟ 

سيتم إرسال سلسلة نصية أو مجموعة من المحارف الخاصة التي لن يتمكن التطبيق من تحويلها بنجاح إلى رقم › مما سيولد خطأاً عند 
محاولة استخدام التطبيق للطريقة ()6١إ (٥٥121.۴4‏ وسيتوقف عمل التطبيق» بعدها سيتم إرسال صفحة الخطاً إلى المستخدم مع 
وصف للخطاً الحاصل . 

يمكن إزالة الخطاً في مثالنا باستخدام الطريقة ۴21e)‏ yإa1.۲صDeci‏ عوضاً .Decimal.Parse() jz‏ 

توفر الطريقة (٥141.1۲۷۴۵۲٥)‏ معاملين الأول خاص بالقيمة المراد تحويلها و الثاني هو معامل خرج يحتوي النتيجة بعد 
التحويل » أما القيمة المعادة من هذه الطريقة فهي قيمة منطقية (عیا۴۵ , عu٣٣).‏ 

ملاحظة: سنتعرف في جلسة لاحقة على كيفية معالجة الأخطاء باستخدام بنى أكثر عمومية 


ستقوم في هذا الجزء من الجلسة بتحسين تطبيقنا عبر وظائف إضافية و استخدام عناصر تحكم مختلفة. 


إضافة عملات متعددة: 
لتمكين التعامل مع عدة عملات سنقوم باستخدام قائمة منسدلة. 


يمكننا إضافة عنصر تحكم 11۷1 خاص بالقائمة المنسدلة باستخدام التأشير ة <ا٥٥561>‏ مع مراعاة عدم إغفال اسناد قيمة للواصفة 


.runat="server" 


<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="CurrencyConverter.aspx.cs" Inherits="CurrencyConverter" %> 
<html xmins="http://www.w3.org/1999/xhtml"> 

<head> 

<title> Currency Converter</title> 

</head> 

<body> 

<form runat="server"> 

<div> 

Convert: &nbsp; 

<input type="text" ID="US" runat="server" /> 

&nbsp; U.S. dollars to &nbsp; 

<select ID="Currency" runat="server" /> 

<br /><br /> 

<input type="submit" value="OK" ID="Convert" 
OnServerClick="Convert_ ServerClick" runat="server" /> 
<br /><br /> 

<div style="font-weight: bold" ID="Result" runat="server"></div> 
</div> 

</form> 

</body> 
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</html> 


بعد أن قمنا بإنشاء عنصر تحكم قائمة منسدلة فارغء سنستخدم الرماز لإضافة عناصر إليه. 


protected void Page_Load(Object sender, EventArgs e) 


{ 
if (this.IsPostBack == false) 


{ 
Currency.ltems.Add("Euro"); 


Currency.ltems.Add("Japanese Yen"); 
Currency.ltems.Add("Canadian Dollar"); 


ر 
1 


تم استخدام الخاصة 618[. تسمح هذه الخاصة بإضافة و حذف عناصر من القائمة. 

قبل إضافة أي عنصر إلى القائمة يجب التأكد بأن الرماز لن ينفذ إلا عند أول مرة يتم فيها إرسال الصفحة للمستخدم › لكي لا ننتهي 
إلى سيناريو يقوم بإضافة عناصر بشكل متكرر إلى القائمة في كل مرة يتم فيها الدخول إلى الصفحة. 

يتم ٬لغرض‏ التأكد من هذه النقطة» التحقق من الخاصة )ءة۴0518] للصفحة الحالية. 

في حال كون قيمة هذه الخاصة الموروثة من صف عه الرئيسي مساوية ل موه فمعناه أن تلك هي المرة الأولى التي يتم فيها 
إنشاء تلك الصفحة لهذا المستخدم و من الآمن تأهيلها. 


تخزين المعلومات ضمن القائمة: 


يمكن وكما نعلم من التعامل مع ا111 أن يكون كل خيار ضمن القائمة المنسدلة مرتبط بالنص الذي يظهر للمستخدم. 
كذلك يمكن اسناد قيمة غير ظاهرة مرتبطة بهذا الخيار > يعبر عنها في ۲۲M]‏ بالواصفة Value‏ . 
للتحكم بالقيم المرتبطة بالخيارات نستخدام الغرض ١٠٠)]آاءا1‏ حيث يوفر هذا الغرض مشيد يسمح لنا بتحديد النص مع القيمة المرتبطة 


عند إنشائه. 


protected void Page_Load(Object sender, EventArgs e) 
if (this.IsPostBack == false) 


/I The HtmlISelect control accepts text or Listltem objects. 
Currency.ltems.Add(new Listltem("Euros", "0.85")); 
Currency.ltems.Add(new Listltem("Japanese Yen", "110.33")); 
Currency.ltems.Add(new Listltem("Canadian Dollars", "1.2")); 
1 


لاتمام عملنا يجب إعادة كتابة النص البرمجي لأخذ نوع العملة المختارة بعين الاعتبار: 


protected void Convert _ServerClick(object sender, EventArgs e) 


{ 
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decimal amount = Decimal.Parse(US.Value); 

/I Retrieve the selected Listltem object by its index number. 
Listltem item = Currency.ltems[Currency.Selectedlndex]; 
decimal newAmount = amount * Decimal.Parse(item.Value); 
Result.InnerText = amount. ToString() + " U.S. dollars = ",; 
Result.InnerText += newAmount.ToString() + " " + item. Text; 


} 


فيمايلي الشكل الذي يوضح شكل التطبيق بعد التعديل 
J Cirreney Earmemiier - Misra lated xq rêr TEE‏ 


Eh f ei Fore. Hie Hein س‎ r 


7 E] ita Ease AO Fat ipa iar ha Hi 


Orywerî FA) l3 Colles lı i panega fen 
B4 


ATS UE, dors = OSA. TS TparEeseê Ten 


CTT 


قمنا في هذا التطبيق بتخزين معدل التحويل ضمن الواصفة ع«1ه۷. ولكن في تطبيقات أعقد قد يكون من الأفضل تخزين المعلومات 
ضمن قاعدة البيانات أو ضمن الذاكرة الخبيئة و تخزين قيمة المفتاح المعرف ضمن الواصفة عu‏ اج۷ . 


إضافة الصور المرتبطة: 


أصبح إدراج وظائف إضافية في تطبيقنا سهلاء بسهولة إضافة زرء فيمكننا مثلاً إضافة صورة تعبر عن منحني تغير قيمة التحويل كما 
يظهر في الرماز: 


<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="CurrencyConverter.aspx.cs" Inherits="CurrencyConverter" %> 
<html xmins="http://www.w3.org/1999/xhtmI"> 
<head> 

<title> Currency Converter</title> 

</head> 

<body> 

<form runat="server"> 

<div> 

Convert: &nbsp; 

<input type="text" ID="US" runat="server" /> 

&nbsp; U.S. dollars to &nbsp; 

<select ID="Currency" runat="server" /> 
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<br /><br /> 

<input type="submit" value="OK" |D="Convert" 

OnServerClick="Convert_ ServerClick" runat="server" /> 

<input type="submit" value="Show Graph" ID="ShowGraph" runat="server" /> 
<br /><br /> 

<img ID="Graph" scr= 
<br /><br /> 

<div style="font-weight: bold" ID="Result" runat="server"></div> 
</div> 

</form> 

</body> 

</html> 


alt="Currency Graph" runat="server" /> 


يكون عنصر تحكم الصورة الذي قمنا بإضافته فارغاً في مرحلة ما قبل الاختيار لذلك من المنطقي إخفاؤه. 


protected void Page_Load(Object sender, EventArgs e) 


{ 
if (this.IsPostBack == false) 


{ 
Currency.ltems.Add(new Listltem("Euros", "0.85")); 


Currency.ltems.Add(new Listltem("Japanese Yen", "110.33")); 
Currency.ltems.Add(new Listltem("Canadian Dollars", "1.2")); 


} 
Graph.Visible = false; 
} 


أما الرماز الخاص بزر إظهار الصورة فهو التالي: 


protected void ShowGraph_ServerClick(Object sender, EventArgs e) 


{ 
Graph.Src = "Pic" + Currency.SelectedIndex. ToString() + ".png"; 
Graph.Visible = true; 


} 
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3 Currency Converter - Microsoft Internet Explorer 
Fil Edit View Fawo’ites Tools Help Qk > © ° A A | e 
1 


Address ا3‎ http ffloacalhast:2O0401ZhaptarDSfZurrartyTanwarktar , aspx 


Convert: Eels Err WI 


USDCAD=# 


2 
WUSA 


http: +#FinancE, yahoo, con” 


375 U.S. dollars = 450.0 Canadian Dolla“s 


¥ ocal intranet 


إعداد الأنماط: 


إضافة إلى المجموعة المحدودة من الخصائص التي توفرها عناصر 11۷1 يمكننا الوصول إلى واصفات .٥8SS‏ 
تتم عملية التحكم بقيم واصفات 0588 من خلال استخدام المجموعة عاراS.‏ 
يتم تحديد اسم الواصفة و القيمة المراد اسنادها إلى تلك الواصفة كما يلي: 

| ControlName.Style["AttributeName"] = "Atiributevalueî |j 
يمكننا استخدام هذا التعبير في متالنا (محول العملات ) لتمييز الإدخال الخاطئ بنمط خاص.‎ 
يجب ألا ننسى أنه لا بد من إعادة قيمة اللون اإلى القيمة الأصلية من أجل الإدخال الصحيح لأن عناصر التحكم تستخدم eه)؟S م۷‎ 
لحفظ جميع إعدادات العنصر بما فيها قيم خصائص النمط.‎ 
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{ 
Result. Style["color"] = "Red"; 
Result.InnerText = "Specify a positive number"; 


} 


else 


Result. Style["color"] = "Black"; 

/I Retrieve the selected Listltem object by its index number. 
Listltem item = Currency.ltems[Currency.Selectedlndex]; 
decimal newAmount = amount * Decimal.Parse(item.Value); 
Result.InnerText = amount. ToString() + " U.S. dollars = ",; 
Result.InnerText += newAmount. ToString() + " " + item. Text; 


ر 
} 


قمنا في هذا الجزء من الجلسة بإتمام تطبيق محول العملات وتعرفنا من خلاله على كيفية إجراء حسابات بسيطة» التعامل مع الصور 
المرتبطة والتنسيق الديناميكي . 


صفوف عناصر تحكم ۲۷1 :H1‏ 


تستخدم صفوف N١‏ . الوراثة لتأمين عملية مشاركة الوظائف. 
على سبيل المثال يرث كل عنصر تحكم ا11۷ من الصف القاعدي 1هء٤‏ 11ء يوفر هذا الصف وظائف أساسية لجميع 


عناصر تحكم 111 من جهة المخدم. 


System. Oo ject 
Stem. UT. Web. Control 


System. Web . UT. Htm1Controls 
HtmlControl 


HmlInputControl HtmlContainerControl 
HtmlFom [j 
HtmLInputCheckBox HtmIGenericControl 
HtmlTable j 
HtmlTableCell |] 


Html Tnput Text Htm1TextArea 
HtmLInputPas sword 
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صفوف ۸8۲.٤١‏ المستخدمة لعناصر تحكم ا1۲۷1 من جهة المخدم 
الجزء التالي من الجلسة سيقوم بتفصيل صفوف ۸8۴.٤1‏ المستخدمة لعناصر تحكم 111 من جهة المخدم. 


توفر عناصر تحكم ]11۷ من جهة المخدم عادة خصائص تطابق بشكل كبير واصفات التأشيرات. 
على سبيل المثال يوفر صف ع2g 811"٣‏ خصائص Border, Src, Height , Width)‏ ,ignاA).‏ لهذا السبب يجد المطورون الذين 
اعتادوا التعامل صفحات 1111 سهولة في التعامل مع هذا النمط من عناصر التحكم. 


أحداث عناصر تحكم :HTML‏ 
توفر عناصر تحکم HTML‏ أیضاً إمكانية الاستجابة لأحد حدثين الأوJ ServerClick‏ و الثاني .ServerChange‏ 
:ServerC1ick ٠1‏ يمكن هذا الحدث من معالجة عملية النقر على العنصر من طرف المخدم. توفر هذا الحدث معظم العناصر 
مٿل عناصر الأزرار و عناص .Htm1Anchor‏ 
:ServerChan8e .2‏ يتم إطلاق هذا الحدث عندما يتم تعديل النص أو الاختيار المحدد في عنصر التحكم. 


ملاحظة: في حالة اهام 1)14 يمكن لعنصر التحكم هذا العمل بطريقتين: 
1. ارتباط مباشرء حيث يقوم بإعادة توجيه التطبيق إلى صفحة معينة 
2. إرسال الصفحة غوديا و عندها سيتم تشغيل النص البرمجي ضمن مقبض الحدث 


الحدث عنصر التحكم الذي يوفر هذا الحدث 
HtmlAnchor, HtmlButton, HtmlInputButton, ServerClick‏ 
HtmlInputlImage, HtmlInputReset‏ 


HtmlInputText, HtmlInputCheckBox, ServerChange 
HtmlInputRadioButton, HtmlInputHidden, 
HtmlSelect, Html TextArea 


الأحداث المتقدمة المستعملة مع عنصر تحكم :Htm1IInput[ mage‏ 


نعلم أن كل حدث يقوم بتمرير معاملين الأول يعرف الغرض (في حالتنا عنصر التحكم) الذي قام بإطلاق الحدث والثاني هو عنصر 
خاص يتضمن معلومات إضافية عن الحدث. 


في المتال الذي تم استعراضه في هذه الجلسة تم استخدام المعامل e‏ لتمریر غرض ع۵۸۲۸۲ ۷٤.٣عtءر؟‏ فارغ. 

لا يحتوي هذا الغرض على أية معلومات إضافية لكنه يوضع فقط لغرض الالتزام بعدد المعاملات التي يستخدمها الحدث. 

في الحقيقة عنصر وحيد فقط من عناصر تحكم ۳۲١۷1‏ يقوم بإرسال معلومات إضافية و هو عنصر llتحكم .HtmlInput[mage‏ 
يقوم هذا العنصر بإرسال غرض ءع۲4۲١ء۷٤)ء1ا٣€ءععه«]‏ الذي يوفر خاصيتي ۷,×. 
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تمثل هاتان الخاصتان إحداثيات الموقع الذي تم النقر عليه ضمن عنصر الصورة. 
يمكنكنا باستخدام هذه المعلومات الإضافية الاستغناء عن مجموعة عناصر تحكم ١0))لاط‏ و "ap‏ eعه٣1‏ وتعويضها بعنصر تحكم 


HtmlInputImage‏ وحيد. 


المثال التالي ×مءه.†ءء1ءع4 "1 يعرض كيفية استخدام عنصر تحكم عع2 .]اام آ1" وتحديد احداثيات النقطة التي تم فيها نقر 


E LIntitled Page - Microsoft Interret Fxplorer ۱8 


Fie Edit Yim Favorites Tools Help O Ear = © DB E 2 
Adtess €] http: ff bcalhostiZLAUFLhaptelSfImagel est, aspx bi 


Click on the [nage 


Tou clicked at (ADA, LA). You cleked the button boarder. 


2 Local intranet 


public partial class ImageTest : System.Web.UI.Page 


protected void ImgButton_ServerClick(Object sender, 
ImageClickEventArgs e) 


Result.InnerText = "You clicked at (" + e.X.ToString() + 
""+e.Y.ToString() + ")."; 

if ((e.Y < 100) && (e.Y > 20) && (e.X > 20) && (e.X < 275)) 
{ 


Result.InnerText += "You clicked on the button surface."; 


} 


else 


Result.InnerText += "You clicked the button border."; 


ر 
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الصف القاعدي :HtmlControl‏ 


الخاصية الوصف 
Attributes‏ توفر مجموعة جميع الواصفات 

Controls‏ تزود مجموعة جميع عناصر التحكم المحتواة ضمن عنصر 
التحكم الحالي 

Disabled‏ عند اسناد القيمة ء۴1 إلى هذه الواصفة لن يستطيع المستخدم 
التفاعل مع عنصر التحكم كما لن يطلق العنصر أي حدث. 
EnableViewState‏ هذه الخاصة مسؤولة عن إدارة الحالة. عند اسناد القيمة عواه؟ 
إلى هذه الخاصة لن يحتفظ عنصر التحكم بأي قيمة للخواص أو 
التنسيقات و سيتم إعادة قيم جميع الخواص إلى القيمة البدائية 
عند كل عملية إرسال الصفحة. 

في حال اسناد القيمة ۲٣٠٠‏ إلى هذا الخاصة سيتم استخدام حقل 
إإخال مخفي لتخزين المعلومات الخاصة بعنصر التحكم. 

تتم هذه العملية لضمان المحافظة على التعديلات التي تمت في 
زمن التشغيل من خلال الرماز. 


Page‏ توفر مرجع إلى غرض الصفحة الذي يحتوي عنصر التحكم 
Parent‏ توفر مرجع إلى الغرض الأب الحاوي على عنصر التحكم. في 
حال تم وضع عنصر التحكم بشكل مباشر ضمن الصفحة ستعيد 
هذه الخاصية مرجع إلى غرض الصفحة. 

Style‏ يوفر مجموعة من خصائص أنماط ءء التي يمكن استخدامها 
TagName‏ يحدد اسم عنصر 11۷1 الموافق لعنصر التحكم مثلاً 
(img,div,..)‏ 

Visible‏ إذا تم اسناد القيمة مء[ه؟ إلى هذه الخاصة سيتم إخفاء العنصر 


و لن يتم تصييره ضمن الصفحة. 


ملاحظة: يمكن اسناد القيم البدائية لهذه الخواص بتحديد هذه القيم ضمن مقبض حدث تحميل الصفحة ل104 ععم۴ . 
كما يمكن أسنادها مباشرة ضمن تأشيرة عنصر التحكم في صفحة ×م4ه بإضافة واصفة بنفس الاسم تحديد قيمتها كما يلي : 


أا 
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:HtmlContainerControl نض‎ 


ترث جميع عناصر التحكم التي تتضمن صيغة التأشيرة الخاصة بها تأشير ة إغلاق (مثJ <div></div>‏ ر (<form></form>‏ 


الصف القاعدي 1)1٣ 0١٤ه1١, ٥۲٣۳0۸٤۲0٥1‏ يقدم هذا الصف خاصتين إضافيتين هما: 


ألخاضة الوصف 
InnerHtml‏ تحدد أو تعيد نص 1”. ۲11 المحصور بين فتح و إغلاق التأشيرة 
يتم تصيير النص كنص 1.1 أي يمكن إضافة تأشيرات 
ضمنية ك<ط/><(> لتتنسيق النص. 

InnerText‏ تشابه هذه الخاصة سابقتها بفرق كونها تقوم بتحويل المحارف 
الخاصة (مثل فتح و إغلاق التأشيرة) إلى مقابلاتها مثلاً سيتم 
تحويل (>) إلى ;1.1& أي سيظهر النص المحدد كقيمة لهذه 
الخاصية تماما كما تم إدخاله. 


:HtmlInputContro]l الصف‎ 


يقدم هذا الصف مجمو عة من الخصائص التي يمكن استخدامها مع تأشيرة <الامم> إذ كما نعلم يمكن لهذه التأشيرة أن تمثل أكثر 
من عنصر تحكم بحسب القيمة المحددة للواصفة e‏ pرا.‏ مث <input type="tex">‏ 

الخاصة الوصف 

Type‏ تحدد هذه الخاصة نوع عنصر تحكم الإدخال › فمثلا عنصر 
التحكم الذي <'٥]۴1"=ءمرآ‏ U1آNP!>‏ سیعید القيمة ٥ا1‏ 
لهذه الخاصة. 

تعيد محتوى عنصر التحكم على شكل سلسة محرفية. يمكن 
استخدام هذه الخاصة في استعادة المعلومات التي تم إدخالها 
ضمن عنصر تحكم الإدخال (كما في مثال محول العملات) 


صف الصفحة eءعوP:‏ 


أي صفحة نقوم بإنشائها هي صف مخصص يرث من الصف مع ۷6.01.۴4 .١ء1ءر؟‏ وبعملية الوراثة تلك تكتسب صفوف 
الصفحات التي ننشؤها خصائص و طرق مختلفة منها ما له دور في عمليات الخبءء التحقق من الصحة و تصيير و إظهار العناصر. 
فيمايلي سرد لأسماء بعض هذه الخصائص وعملها: 

الخاصية الوصف 

IsPostBack‏ تعيد هذه الخاصة قيمة منطقية. 

تأخذ هذه الخاصة القيمة ماه في حال كانت تلك هي المرة 
الأولى التي يتم فيها إرسال الصفحة. 
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EnableViewState‏ هذه الخاصة مسؤولة عن إدارة الحالة. عند اسناد القيمة عواه؟ 
إلى هذه الخاصة لن يحتفظ عنصر التحكم بأي قيمة للخواص أو 
التنسيقات و سيتم إعادتها للقيمة البدائية عند كل عملية إرسال 
الصفحة. 

أما في حال اسناد القيمة إلى 1٠٠٠‏ إلى هذه الخاصة يقوم 
عنصر التحكم باستخدام حقل إدخال مخفي لتخزين المعلومات 
الخاصة به لضمان الاحتفاظ بالتعديلات التي تمت في زمن 
التشغيل من خلال الرماز . 


Application‏ تعيد مجموعة تحوي المعلومات المشتركة بين كل المستخدمين 
للموقع . 

Session‏ تعيد مجموعة تحوي معلومات خاصة بمستخدم واحد › ليتم 
استخدامها عبر أكثر من صفحة . 

كن مكلا ادام ها رض اتكرين رمات اة الشران 
للمستخدم حين تتم عملية الشراء عبر أكثر من صفحة . 

تعيد هذه الخاصة مجموعة تمكن من تخزين الأغراض التي 
تستغرق وقتأً ليتم إنشاؤها بغرض إعادة استخدامها في صفحات 
أخرى لزبائن آخرين و دون الحاجة إلى إعادة إنشائها. 


Request‏ يعيد مرجع إلى غرض اءء ٠٩ء۸‏ م])۲1 الحاوي على معلومات 
حول طلب وب الحالي » يمكن الاستفادة من هذه المعلومات 


لمعرفة نوع المستعرض الذي يستخدمه الزبون. كما و يستخدم 
بشكل أساسي لنقل معلومات من صفحة إلى أخرى عبر الخاصة 
QueryString‏ 

Response‏ تعيد مرجع إلى غرض عك١0مء٠۸‏ ما1 الممثل للاستجابة التي 
سترسلها N٤1‏ .م۸ إلى مستعرض الزبون. 

يمكن استخدام هذا الكائن أيضاً لإعادة توجيه المستخدم إلى 
صفحة أخرى أو عند العمل مع الكعكات. 

تعيد مرجع إلى غرض أ1ا إء۷إء؟ ما الذي يسمح بأداء 
مجموعة مختلفة من المهام. على سبيل المثالء تمكن من تحويل 
النص إلى نمط آمن ليتم استخدامه ضمن 081 أو في تأشيرة 
HTML‏ 

سوف تعيد هذه الخاصة معلومات المستخدم الحالي إذا تم التحقق 


من هوية المستخدم. 
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توجيه المستخدم إلى صفحة جديدة: 
إذا عدنا للمتال الذي عملنا عليه في الجزء الأول من هذه الجلسة و الخاص بتطبيق محول العملات سنلاحظ أن العمل كله قد تم ضمن 
صفحة وأحدة. 
سنتعلم في هذا الجزء كيفية الملاحة من صفحة إلى أخرى و إعادة توجيه المستخدم. 
هناك عدة طرق لنقل المستخدم من صفحة إلى أخرى. 
تعد الطريقة الأسهل لتحقيق هذا الغرض هي استخدام تأشيرة <ه> التي تحول النص الذي تحصره إلى وصلة تشعبية في هذا المثال 
اط هي الوصلة إلى الصفحة الأخرى: 


يتوفر خيار آخر لإرسال المستخدم إلى صفحة أخرى هو استخدام الرماز. 
تعد هذه المقاربة أفضل عندما نريد من النص البرمجي أن يقوم بعملية ما قبل إعادة توجيه المستخدم أو في حال أردنا الرماز أن يقرر 
أين سيتم توجيه المستخدم (حالة كون النص البرمجي يتأكد من كون المستخدم جديد فيحوله إلى صفحة التسجيل أو مستخدم حالي 
فيحوله إلى صفحة الشراء مثلا.) 

يمكنك الاستفادة من مقبض الحدث )ء1٣5۲۷6۲‏ للتحكم بتحويل المستخدم إلى صفحة أخرى. 

يمكنك الوصول إلى غرض عك١٠0مءء۸م))1‏ الحالي عبر الخاصة .Page.Response‏ 

المثال التالي يقوم بإرسال المستخدم إلى صفحة أخرى على نفس مجاد الموقع: 


عند استخدام الطريقة ۸1٣٠٥٤‏ توقف ۸8۶.۸61 فوراً عملية معالجة الصفحة و يتم إرسال إعادة توجيه إلى الزبون. 


لن يتم تنفيذ أي رماز برمجي ضمن الصفحة بعد الطريقة d۲t‏ هR.‏ 


كما و يمكن استخدام الطريقة rans‏ الخاصة ڊlÛئj .HttpServerUtility‏ 

تتميز هذه الطريقة بأنها لا ترسل رسالة إعادة توجيه إلى المستعرض و لكن تقوم بنقل التنفيذ إلى صفحة أخرى على المخدم وكأن 
الممشخدم طلب هذه الصقخة ألا 

إن محدودية هذه الطريقة تتمثل في عدم قدرتها على تحويل المستخدم إلى صفحة خار ج الموقع أو صفحة ليست صفحة ۴1 A۸S8P.N‏ 
كصفحة 1ه مثلاً. 


:HTML jıaرت‎ 


كما نعلم هناك مجموعة من المحارف المعينة التي لها معاني خاصة في ا1۷[ فعلى سبيل المتال تستخدم محارف إشارتي أكبر 
وأصغر (<>)لإنشاء التأشيرات. 
قد تسبب هذه المحارف مشكلة في حال أردنا استخدامها كجزء من المحتوى على صفحة الوب 
مثلاً إذا أردنا كتابة العبارة 

Enter a word <here> 
ستكون النتيجة في حال تم استخدام هذا النص لوضعه على الصفحة‎ 

Enter a word 

لتتجنب تفسير هذه المحارف الخاصة و تقوم بإظهارها تماما كما تمت كتابتها يمكنك استخدام الخاصة 1,1۵۲۲١×٤‏ التي قمنا بشرحها. 
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و لكن ماذا لو لم توفر هذه التأشيرة الخاصة ۴×٤‏ ۲۲ع,]!؟ 
الحل في هذه الحالة اعتماد الطريقة HttpServerUtility ضرغll Htm1E£nc0de)‏ 


:)InnerHtml pIدختl)‎ Jاٿم‎ 


:(HtmlIEncode plدختl)‎ Jlثn‎ 


الشكل التالي يوضح نتيجة تنفيذ المثالين السابقين: 
Untitled Page - Microsoft Internet Explorer‏ 3 
r‏ و File Edit jew Favorites Tools Help € Eack ” 3 E E‏ 
ess‏ 


Properly encoded: 


To bold tezt use the <b> tag. 


Incorrectly encoded: 


To bold tezt use the tag. 


| لر‎ Local intranet 


هذه المقاربة مفيدة جداً عندما نريد عرض بيانات تمت استعادتها من قاعدة البيانات. 

يمكننا إن أردنا إعادة النص من جديد إلى وضعه الأساسي قبل تحويل المحارف الخاصة باستخدام الطريقة 0)ءل0ءء10ص)5. 
یوفر الغرض !اا٤‏ ۲0ء۲۷٥5‏ م))H1‏ طریقتین مشابھتین مفیدتین أيضاً ھما Ur1Encode)(‏ و 0ءr]Decode€‏ یمکن استخدام ھاتین 
الطريقتين عند تمرير معلومات بين الصفحات ضمن ترويسة طلب م1 بإضافتهاإلى عنوان ا0R1.‏ 
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خلال سياق هذه الجلسة رأينا كيف توفر ۸8۶.٤1‏ إمكانية معالجة الأحداث من خلال كتابة رماز مقبض الحدث. 

و مع أن عناصر التحكم هي المصدر الأساسي للأحداث لكن هناك نوع آخر من الأحداث الذي نتعامل معه أحياناً . 

هذه الأحداث هي أحداث التطبيق. 

تستخدم أحداث التطبيق لأداء أعمال تتعلق بجميع الصفحات في التطبيق مثلاً يمكن أن يكتب رماز تسجيل الدخول ضمن مقبض حدث 
التطبيق ليتم استدعاؤه في كل مرة يتم فيها استقبال طلب على صفحة مهما كانت تلك الصفحة. 

لا يمكنك معالجة أحداث التطبيق في الرماز في الخلفية و تحتاج لإتمام هذه العملية إلى مكون جديد هو ملف ×هءه.41طه1ا6. 


الملف ×هيه.اbaهlاG:‏ 


يسمح الملف ×44ه.610041 لنا بكتابة النص البرمجي للاستجابة لأحداث التطبيق. يتم إطلاق هذه الأحداث أثناء مراحل العمل 
المختلفة. 

WebSite-> add New Item رتëخl‎ Visual Studio لإضافة ملف ×هوه.[دطم61 إلى التطبيق في‎ 

ثم قم باختیار ×ھیھ.41ط٥اع‏ ثم اضغط علی خیار .0K‏ 

إن ملف ×هءه.41طه61 مشابه من حيث الشكل لملف ×مھ بفرق کون الأخير لا يستطيع احتواء تأشيرات ASP.NET yi HTML‏ 
و يحتوي بدلا عنها مقابض أحداث > على سبيل المثال يحدد ملف ×هوه.1ةطه[ن التالي استجابة نلحدث Application.EndRequest‏ 
الذي يتم إطلاقه في كل مرة قبل إرسال صفحة إلى المستخدم: 


يقوم هذا المقبض باستخدام الطريقة ۷۲٤0‏ لغرض ١٠ص٠۸‏ لإضافة تذييل إلى أسفل الصفحة تبين التاريخ و الوقت الذي تم فيه 
خلق الصفحة. 


Universal Knowledge Solutions s.a.1. 
60 


This page was served at 9/1/2007 5:00:53 PM 


a @ Internet | Protected Mode: On 


يمكن لكل تطبيق ۸8۴.٤1‏ أن يحتوي ملف ×610041.444 وحيد يتم التعرف آليا عليه و استخدامه في حال وجوده ضمن مجلد 
التطبيق. 


المزيد من أحداث التطبيق: 


هناك الكثير من الأحداث الخاصة بالتطبيق بالإضافة إلى انحدث .Application.End Request‏ 
لإنشاء مقابض الأحداث يكفي أن تعريف الإجرائيات الفرعية بالاسم المحدد. 
فيما يلي جدول يتضمن أسماء أهم طرق مقابض الأحداث ووصف لعملها: 

Application_StartO‏ يتم إطلاق هذا الحدث في المرة الأولى التي يتم فيها استقبال 
طلب من أي مستخدم و لمرة واحدة. يستخدم هذا المقبض عادة 
لتأهيل بعض المعلومات الأولية التي سيتم إعادة استخدامها 
لاحقاً. 
Application _ End)‏ يتم إطلاق هذا الحدث عند إنهاء عمل التطبيق عادة بسب إعادة 
تشغيل مخدم الوب » يمكن في هذا المقبض استخدام رماز بمهمة 
إجراء عمليات تنظيف و تحرير للموارد المحجوزة. 
Application BeginRequestO)‏ يتم إطلاق هذا الحدث مع كل طلب يستقبله التطبيق قبل تنفيذ أي 


صفحة. 


Application EndRequestO)‏ يتم إطلاق هذا الحدث مع کل طلب يستقبله التطبیق تماما بعد 
تنفيذ رماز الصفحة. 


Session_StartO‏ يتم إطلاق هذا الحدث عندما يتم استقبال طلب من مستخدم جديد 


نقصد بمستخدم جلسة جديدة). 
م 5 
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Session_End0‏ يتم إطلاق هذا الحدث عند انتهاء زمن الجلسة أو عند إنهائها 
برمجياً » يتم إطلاق هذا الحدث فقط عندما تستخدم خيار 
[P0‏ لتخزين الجلسة و ليس Sta) eSe۷ ٥‏ أو 
.SQLServer‏ 

Application_Error(‏ يتم إطلاق هذا الحدث تجاوباً مع الأخطاء التي لا تتم معالجتها. 


:ASP.NET تlدlدعإ‎ 


الموضوع الأخير الذي سيتم تناوله في هذه الجلسة هو ملف الإعداد في .۸8۲.N٤1‏ 

يحتوي كل تطبيق وب على ملف عاگصهء.ط6س الهدف من هذا الملف هو تشكيل الإعدادات الأساسية للتطبيق ابتدءا من طريقة التعامل 

مع رسائل الخطأً و حتى إعدادات الأمن الخاصة بحجب الزوار الغير مرغوب بهم. 

لاستخدام الملف عاگصهء.طاءس هناك العديد من المميزات أهمها: 

1. غير مغلق: أي يمكن تحديث ملف الإعدادات حتى أثناء عمل التطبيق حيث ستحتفظ الطلبات التي تم استقبالها قبل التعديل 
بنفس الإعداد في حين تخدم الطلبات القادمة بعد التعديل وفق الإعداد الجديد. 
يمكن الوصول إليها بسهولة و نسخها: مثلاً يمكن الوصول إليها عبر حاسب بعيد في حال توفرت الصلاحيات المناسبة » كما 
یمکن نسخها بغرض تطبیقها على تطبیق آخر. 
يمكن فهم محتواها و تحريرها بسهولة : تعتبر الإعدادات المستخدمة قابلة للقراءة المباشرة من المطور بسهولة كما يمكن 
تعديلها بواسطة أي محرر نصوص عادي دون الحاجة إلى أدوات تشكيل خاصة 


:Web.config أف‎ 


يستخدم ملف عاگمهء.طءس تنسيق ۷× بتأشيرات مسبقة التعريف. كامل محتوى الملف متضمن داخل تأشيرة الجذر 
.>configurat101<‏ يوجد داخل هذه العنصر مجموعة من الأقسام الفرعية » بعضها يندر تغييره و البعض الآخر هام جداً ویستخدم 


فيما يلي الهيكيلية الأساسية لملف عا؟ط0ء.ط٠س‏ موضحا فيه الأقسام الفرعية الأهم: 
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يفيد الجز ء <ع”اا؛ه5ممه> في إضافة معلومات عامة يمكنك استخدامها ضمن التطبيق. في حين تم تخصيص القسم الفرعي 

>connectionStrin 8<‏ لتعريف ممعلومات الاتصال إلى قاعدة المعطيات. 

أما القسم الفر عي <طءw.ءtءرء>‏ فهو مسؤول عن ضبط إعدادات ۸8۴.٤1‏ حيث يتوفر ضمن هذ القسم عناصر تتعلق بكل 
ناحية من نواحي إعدادات التطبيق. 

إذا أردنا مثلاً تخصيص إعدادات الأخطاء يكفي إضافة التأشیر ة <۲۶٥0۴۲۲اواء>‏ ضمن تأشير ة<اeس.0۸ا8إء>‏ 


إذا أردنا التحكم بإعدادات الأمان في ۸8۴.٤1‏ يمكن التفكير بإضافة التأشير ة ١<‏ 0نا ء1٤6‏ طا >u‏ ضمن القسم 


.<authorization> 
الإعداد بطريقة الاحتواء:‎ 


تستخدم ۸8۴.٤1‏ إعدادات تعتمد تعددية الطبقات التي تسمح بتعيين الإعدادات على أكثر من سوية. 

يبدأ أي مخدم وب بإعدادات رئيسية يتم تعريفها ضمن ملفين في المجلد 

.web.config yg machine.config laa jllnll ila c:\Windows\Microsoft. NET\Framework\v2.0.50727\Config 
لن تقوم بتحرير محتوى أي من هذين الملفين بشكل يدوي بشكل عام لأنهما يؤثران على الجهاز كاملا > عوضاً عن هذا سنقوم بتحرير‎ 
الإعدادات لملف عاكمهء. ط6س الموجود في مجلد التطبيق الخاص بنا. حيث يمكننا إضافة معلومات جديدة أو إعادة تعريف الإعدادات‎ 
الافتراضية التي تم تحديدها ضمن الملفين السابقين.‎ 

و المثير للاهتمام أكثر أنه بإمكاننا حتى تعديل الإعدادات لأجزاء مختلفة من التطبيق .لهذا الغرض لا بد من إنشاء مجلدات فرعية 
تستطيع احتواء ملف عاگرهء.اءس الخاص بها. 


لنفرض مقلا أننا قمنا بإنشاء مجلد ضمن الفهر س esi e5\S e112‏ 1\1 £ASP.N::ء‏ فإن بإمكانه الاستحصال على المعلومات من 
ثلاث ملفات كما يظهر في الشكل التالي: 
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Machine.config and root web.config 
(applies to all web applications on the server) 


Web App 
c: NASP .Net\Testheb\web. config 
(applies to all pages in Testkeb) 


11cWarld . ã 
c: ASP .NET\TestWeb"1Secure' 


web. config 
(applies to pages in Secure directory) 


كما نلاحظ أن الإعدادات الموجودة ضمن أي ملف 1gگmachine.con‏ و web.config‏ سيتم إعتمادها ما لم يتم إعادة تعريفها. بهذه 
الطريقة لسنا بحاجة لإعادة تعيين الإعدادات كاملة في كل سوية و يكفي إعادة تعريف الإعدادات الخاصة بالتعديلات المراد تطبيقها 
على محتوى المجلد المحدد. 


تخزين الإعدادات المخصصة ضمن ملف عٍاگر٥ء.web:‏ 


تمكن ۸8۴.٤1‏ من عملية تخزين أية إعدادات خاصة إضافية يرغب بها المطور ضمن ملف عاگدهء.ا٠س‏ في العنصر المسمى 
>appSetting<‏ حيث يكون هذا العنصر محتوى ضمن العنصر الجذر للف .<configuration> yay web.config‏ 
النلص التالي يبين هيكلية هذا الملف: 


<?xml version="1.0" ?> 
<configuration> 


<appSettings> 
<!-- Custom application settings go here. --> 
</appSettings> 


<system.web> 
<!-- ASP.NET Configuration sections go here. --> 
</system.web> 


</configuration> 


تكون الإعدادات الخاصة التي تود إضافتها مكتوبة كمتحول سلسة محرفية بسيط. 
يمكن أن نحتاج إلى إعدادات خاصة في عاگط0ء.ا٠س‏ لعدة أسباب: 


Universal Knowledge Solutions s.a.1. 
64 


مركزية الإعدادات الهامة التي تستخدم في أكثر من صفحة. مثلاً قد تقوم بإنشاء متحول يقوم بتخزين متحول يحتوي استعلام 
من قاعدة البيانات عندها تستطيع أي صفحة الوصول إلى هذه القيمة باستعادتها من ملف عاگ٬web.co‏ 

لتمكين طريقة سهلة و سريعة للتحويل بين أنماط تشغيل مختلفة للتطبيق. 

لإعطاء قيم أولية لبعض العناصر » حيث يقوم المستخدم بتغييرها إن رغب أثناء التشغيل و لكنها توفر القيمة الافتراضية. 


للوصول إلى الإعدادات المخصص التي قمنا بتحديدها عن طريق الصف Web٣ همf۴اعu 410١‏ الموجود ضمن الصف: 


ملاحظة: تم إعداد ۸58۴.8۲ لترفض بشكل تلقائي أي طلب للوصول إلى ملفات عاگمه»ء. بمعنى أن أي مستخدم بعید لن يتمکن من 
اوضرزل لن امات عن طريق مخ 115 


أداة إدارة الموقع (۷۸1) 


إن تحرير ملف عا« هء.ط٠س‏ بشكل مباشر يمكن أن يصبح عملية مضجرة.لذلك و لجعل عملية التحرير أكثر مرونة قامت 
8P.NE1‏ بتضمین اداۃ إعداد خاصة بواجهة رسومية تسمح بالعمل على الأقسام المختلفة لملف عاگرeb.c0مw.‏ 
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3 
@ ASP.Net Web Application Administration - Windows Internet Explorer 


٠ ¥ 3 http://localhost53188/ asp.netwebadminfiles/default.aspx?applicationPhysicall ¥ ¥ 4‏ ا 


# 


TF HF | ASP.Net Web Application Administrati... E 7 dh ~ Page ” GF Tools v 


ASP Web Site Administration Tool How do I use this tool? @) 
| Searîy Û Appleton Û Provder | 


Welcome to the Web Site Administration Tool 


Application:'Chapter0s 
Current User Name:MAT THEWMYMAT THEW 


Enables youı to set up and edit users, roles, and 
access permissions for your site. 

Site is using windows authentication for user 
management. 


Security 


Application Enables you to manage your application's 
Configuration configuration settings. 


Provider Enables youı to specify where and how to store 
Configuration administration data used by your Web site. 


r @ Internet | Protected Mode: On 


يمكن استخدام هذه الأداة لأتمتة التغيرات على ملف عاگم0ء.اعس. 

توفر الأداة إمكانية ضبط الإعدادات العامة للتطبيق إضافة إلى تلك المتعلقة بالأمان و الاتصال بقواعد البيانات. 

فإذا أردنا تعيين قيمة للمتحول ط٤ة۴:1۴ةة‏ كما فعلنا يدوياً في المثال السابق يكفي الوصول إلى الأداة عن طریق خیار» ۸8۴ 
.configuration‏ تم اختیار التبويب ۸٥1اهء1امم4‏ و النقر على الوصلة ع1 Create new applزication se1‏ وإدخال اسم المتحول 
والقيمة الخاصة به. 
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@ ASP.Net Web Application Administration - Windows Internet Explorer 


a ® ¥ #8 f localhost:S3188/asp.netwebadminfilesappConfig 


E Ë ASP.Net Web Application Administrati... سے‎ Fh 7” f v~ r Page ” EF Tools v 


# 


ا 


ASP Web Site Administration Tool How doa I use this tool? @) 
Home ÛÛ Searîy Û Application Û Froude | 


Use this page to edit, override, or delete application settings 
that you do not want to hard-code into your pages. Settings 
can be local to your applıcatıon or can be ınherıted tram a 
default site-wide or coamputer- wide configuration, If a setting I5 
inherited, you can override It to specify a new value for your 
application. 


Source Name Value 


Local OGataFilePath e:NetworkSharePDocumentsWebAppghared Edit Delete 
Existing application settings: 1 
Create naw application setting 


® @ Internet | Protected Mode: On 


ستقوم هذه الأداة تلقائياً بتوليد وإضافة إعداداتنا الجديدة على ملف عامهء.ط٠س‏ الخاص بالتطبيق. 
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الفصل السابع والثامن 
عناصر تحكم الوب 


يحصل الطالب في نهاية هذه الجلسة على فهم ل: 
1 ماهية عناصر الوب 
2 الاختلاف بين عناصر الوب و عناصر تحكp HTML‏ 
3. تأشيرات عناصر الوب الأساسية ٬الخصائص‏ و الأحداث 
4 الصفوف القاعدية الرئيسية لعناصر الوب و بنيتها 
5 الترقيم و استخدامه للتعامل مع قيم الخصائص لعناصر الوب المختلفة 


عناصر تحكم الوب: 


تم في الجلسة الماضية التقديم للنموذج الذي تعتمده ۸8۴.٤1‏ في البرمجة الموجهة بالأحداث. 

يعتمد هذا النموذج على عناصر التحكم ويسمح »كما شاهدناء بتطوير تطبيقات الوب بالاعتماد على نفس التقنيات التي تستخدم عادة لبناء 
تطبيقات 0wsل‏ ,٣1س‏ العادية. 

تقدم عناصر تحكم ا11 من جهة المخدم جزءاً بسيطا جداً من الفوائد التي يقدمها نموذج البرمجة من جهة المخدم في .۸9۶.N٤‏ 
ولكن للوصول إلى الميزات الحقيقية ل ۸5۴.٤1‏ لا بد لنا من استخدام عناصر تحكم أكثر مرونة وقابلية للاتطوير. هذه العناصر 
هي عناصر تحكم الوب. 

لفهم عناصر التحكم و استعمالها بشكل تطبيقي سنعتمد مثال ( تطبيق بناء بطاقة تهنئة الكترونية على صفحة الوب) وسنحاول تطبيق 
معظم المعارف المكتسبة على هذا المثال. 


٠‏ تم بناء عناصر تحكم الوب بحيث توفر واجهة غنية للمستخدم دون أن تكون بالضرورة مقابلة لأحد العناصر المستخدمة في 
lغة .HTML‏ 

مثلاً »إذا قمنا باستخدام عنصر تحكم ٣هل‏ ١عاة٥‏ و 1٥W‏ 6۲13۷ سنحصل على خرج صفحة يتضمن عشرات من تأشيرات 

.HTMLAd 

ه في عناصر تحكم الوب لسنا بحاجة لأن نعرف أي شيء عن ا11۷ لأن عنصر التحكم ينشئ تأشيرات ا".)1 نيابة عنا. 

٠‏ توفر عناصر تحكم الوب نموذج أغراض متجانس: بعكس ما رأيناه في عناصر تحكم 11١1‏ من جهة المخدم .فإذا أخذنا 
على سبيل المثال علبة الإدخال البسيطة سنلاحظ بأننا سنحتاج إلى ثلاثة عناصر تحكم 11M]‏ للحصول على الوظيفة 
المناسبة وهي <")×ع†"=eٍصty <input‏ و >input text>" Password">‏ وعنصر التحكم <4۲2)×ع)>» في حین یتوفر 
عنصر تحكم وب واحد يوفر كل هذه الإمكانيات. 
تقوم عناصر تحكم الوب بضبط الخرج بشكل آلي»حيث يمكن لعناصر تحكم الوب أن تتعرف على أنواع المستعرضات وتقوم 
بعملية ضبط آلي لخر ج 1١1‏ المتولد لتتمكن من الاستفادة من المزايا التي يوفرها المستعرض (مثل دعم أمإءءvaه[).‏ 
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٠‏ توفر عناصر تحكم الوب مزايا عالية المستوى قياساً مع تلك المتوفرة في عناصر تحكم 1 11. حيث توفر هذه العناصر 


المزيد من الأحداث و الخصائص و الطرق. 


صفوف عناصر تحكم وب الرئيسية: 


يحتوي الجدول التالي قائمة بصفوف عناصر تحكم وب الأساسية وتأشيرات ا11 التي تولدها. 
بعضن غتاضر التحكم هذه كما ذكرناء يتم تصييرها أحيانا بأكثر من تأشيرة. كما أن البعض منها أيضا لا بملك مرادفات في 
H[[ML‏ مثل عناصر تحكم Check8B0xList‏ أو ist‏ اRi0Button‏ فالخرج الخاص بها هو تركيبة من أكثر من تأشيرة. يتم 


تصيير عناصر التحكم السابقة عادة كتأشيرة جدول <1#طاه)> تحتوي مجموعة من تأشیر ات gi <input type="checkbox">‏ 


.<input type="radio"> 
Label 


Button 


TextBox 


CheckBox 
RadioButton 
Hyperlink 
LinkButton 
ImageButton 
Image 


ListBox 


DropDownList 


CheckBoxList 


RadioButtonList 


BulletedList 


تأشيرة 1٧1M‏ المو افقة 
<span>‏ 


<input type="submit"> or <input type="button"> 


<input type="text">, <input type 


1 


password">, or 
<textarea> 


<input type="checkbox"> 
<input type="radio"> 
<a> 
<a> with a contained <img> tag 
<input type="image"> 
<img> 
"12ء ٤٥عاعوكحيث يمتل × عدد الصفوف التي يتم‎ "< 
إظهارها من خيارات اللائحة.‎ 
<select> 


قائمة مكونة من تأشيرة <٥1طه)>‏ إضافة إلى مجموعة من 


<input type="checkbox"> ٽl تأشير‎ 


قائمة مكونة من تأشيرة <٥1طه)>‏ إضافة إلى مجموعة من 


<input type="radio"> تشير ات‎ 


An <ol> ordered list (numbered) or <ul> 
unordered list (bulleted) 
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<div> Panel 


<table>, <tr>, and <td> or <th> Table, TableRow, and TableCell 


تأشيرات عناصر تحكم الوب: 


لتأشيرات عناصر تحكم الوب تنسيق خاص فهي تبدا دائماً بالسابقة :م45 متبوعة باسم الصف. 

في حال لم تكن التأشيرة تستلزم وسم إغلاق يجب أن تنتهي ب </ (تم اشتقاق هذه الصيغة من قواعد كتابة 1× ). 

كل واصفة ضمن التأشيرة تعبّر عن خاصة لعنصر التحكم إلا الواصفة "۷۵۲إ#ء"<4"نإ التي تحدد كون عملية معالجة عنصر 
التحكم ستتم على المخدم. 


عندما يقوم الزبون بطلب الصفحة الحاوية على عنصر التحكم هذا سيتم إعادة خرج 1۲1 التالي: 


يمكنك التحكم بخصائص عنصر التحكم هذا كتعيين قيمة للنص وتحديد حجمه أو جعله مخصص للقراءة فقط وتغيير لون الخلفية. 
تسمح llخاصة ia TextBox. TextMode‏ بتحديد كون عنصر التحكم سيعمل كعنصر إدخال نص بسطر وحيد أو متعدد الأسطر أو 
عة نض مخضصصة لإكخال كلمة السر: 

یمکننا تحدید اللون باستخدام خصائص ٥010۲‏ )Kءه8‏ و ۴١۲٣٥10۲‏ و تعديل حجم علبة النص باستخدام الخاصة كس۸R0W.‏ 

يظهر النص البرمجي التالي مثالا عن علبة نص مخصصة: 
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Î Untitled Page - Microsoft Internet Explorer 8 x 


FF 5 
Fle Edit Yim Faworites Tools Hı (Bat < 


Addrssz 31 HEEpi ff localhost i 221 BYWeabTontrols"TeaxtBEonxT as: aspx 


Hello World 


| ر‎ Local intranet 


أما نص 1۷1[ الناتج عند تصيير عنصر التحكم هذا فهو على الشكل: 
Jonly="readonly" ID="txt‏ 


ملاحظة هامة: 8۴.٤1‏ غير حساسة لحالة الأحرف في الجزء الخاص بتأشيرات عناصر التحكم. 
صفوف عناصر تحكم الوب: 
تعرآف عناصر تحكم الوب ضمن فضاء الأسماء sاهاأo System.Web.01. Web٣‏ وتتبع هرمية مختلفة عن تلك الخاصة بعناصر 


تحكp HTML‏ . 
يظهر الشكل التالي هرمية عناصر تحكم الوب: 
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tyetem .Ohjert 
System, UI. Web. Control 


stem. Web. UL. WebControls 


Placeholder AdRotator 
DetailsView 
[Image | HierarchicalDataBoundControl 
ValidationSunmar 
Listcontrol 
able 
BuLletedList 


صف €٣ 01٤۲0٥1‏ (طء۷ القاعد ي : 


ترث معظم عناصر تحكم الوب الصف القاعدي ۷0٣01٤۲01‏ ءحيث يحدد هذا الصف الوظائف الأساسية مثل المهام الخاصة بعملية 
الربط مع قواعد البيانات. 
يوضح الجدول التالي أهم خصائص هذا الصف: 

الخاصة الوصف 
تحدد هذه الخاصة الاختصار لنقل التركيز إلى عنصر التحكم. 
تأخذ هذه الخاصة قيمة مكونة من محرف واحد »حيث يؤدي 
ضغط هذا المحرف إضافة إلى زر ۸1١‏ إلى انتقال التركيز إلى 
العنصر. 
تحدد هذه الخواص لون الخلفية ءالكتابةو لون الإطار 


AccessKey 


BackColor, ForeColor, and BorderColor 


BorderWidth‏ تحدد هذه الخاصة سماكة الإطار الخاص بعنصر التحكم. 


BorderStyle‏ يمكن لهذه الخاصة أن تأخذ إحدى القيم مسبقة التعريف و التي 
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Dashed, Dotted, Double, رڙlط¦¡إلl‎ طai تحدد‎ 

Noneg Groove,Ridge,Inset,Outset, Solid 

Controls‏ تعيد هذه الخاصة مرجع إلى مجموعة جميع عناصر التحكم التي 
يحتويها عنصر التحكم هذا. 

إن مرجع الغرض الذي تتم إعادته ينتمي إلى الصف القاعدي 
.System. Web.UI.Control‏ 

لذا لا بد من تحويله في حال الرغبة بالوصول إلى الخصائص 
المميزة لعنصر التحكم المحتوى. 

Enabled‏ عند إسناد القيمة 0ء۴41 إلى هذه الخاصة سيبقى عنصر التحكم هذا 
مرئياً ولكن لن يستطيع تقبّل أي دخل من أو الحصول على 
التركيز . 

EnableViewState‏ عند إسناد القيمة #ءاه؟ إلى هذه الخاصة يتم إيقاف تفعيل إدارة 
الحالة التلقائية لعنصر التحكم . 

ستعود في هذه الحالة جميع خصائص عنصر التحكم إلى قيمتها 
البدائية في كل مرة يتم فيها إرسال الصفحة.. 

التي تم تحديدها في الواصفة الخاصة بتأشيرة عنصر التحكم. 

أما إذا تم إسناد القيمة ٠٠٠٠١‏ إلى هذه الخاصة قسيقوم عنصر 
التحكم باستخدام حقل إدخال مخفي. لتخزين معلومات عن 
الخضاتضن: 

تضمن هذه العملية إمكانية الاختفاظ يأية تعديلات تم إجراؤها عن 
طريق الرماز على خصائص عنصر التحكم 

Font‏ تحدد هذه الخاصة نوع الخط المستخدم في تصيير أي نص ضمن 
عنصر التحكم . 

تحدد هذه الخاصة ارتفاع و عرض عنصر التحكم. 

يتم إهمال قيم هذه الخصائص في بعض عناصر التحكم عند 
استخدامها مع نسخ قديمة من مستعرضات الوب. 

Page‏ تعيد هذه الخاصة مرجع لصفحة الوب الذي يحتوي عنصر التحكم 
كغرض من lئصڙ System.Web. U1.Page‏ 

Parent‏ تعيد هذه الخاصة مرجع إلى عنصر التحكم الأب االذي يحتوي 
عنصر التحكم . 

ستعيد هذه الخاصة مرجع إلى صفحة الوب الحالية في حال تم 
وضع عنصر التحكم بشكل مباشر ضمن الصفحة. 

TabIndex‏ قيمة عددية تمكن من عملية التحكم بتسلسل انتقال التركيز بين 
عناصر التحكم المختلفة لدى ضغط زر اه1 


Height and Width 


ToolTip‏ تحدد هذه الخاصة قيمة نصية يتم إظهارها عند وضع مؤشر الفأرة 
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فرق الصر: 

E‏ عند إستان القيدة #واةا إلى هذ الخاصة ميختفى عنصن التحكم 
ولن يتم تصييره ضمن خر ج 1۲۷11 النهائي للصفحة التي سيتم 
إرسالها إلى الزبون. 


الوحدات المستخدمة: 
تستخدم البنية ٤ص0‏ في جميع وحدات القياس .BorderWidth, Height, Width Ja‏ 
تجمع هذه البنية القيمة العددية مع نوع القياس متل (... 488٤١١١۲ءص,ام×م)ء‏ لذلك يجب عند إدخال قيمة أحد هذه القياسات تحديد 
نوع القياس كما في المتال: 


أما عند استخدام هذه القيم ضمن الرماز فعلينا استخدام الطرق الساكنة التي يوفرها ٤لا‏ كما يظهر في المثال التالي: 


كما يمكننا إنشاء غرض ادل ثم تأهيله بالبيانات كما في المثال: 


:(Enumerations) الترقيم‎ 


يستخدم الترقيم بشكل كبير في صفوف .N١‏ لتجميع الثوابت ذات الصلة. 

على سبيل المثال عند اسناد قيمة إلى الخاصة #ارا6۲8ل80 يمكننا الاختيار من مجموعة من القيم مسبقة التعريف للترقيم 
.BorderStyle‏ 

للوصول إلى ترقيم محدد من المجموعة نستخدم صيغة (النقطة .): 


أما ضمن ملف ×صه فيتم تعيين قيمة الترقيم بسلسلة محرفية من أحد الخيارات المتاحة للترقيم. 
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الألوان: 


تعيد الخاصة 1ه مرجع إلى غرض ٥٠1٥١‏ .ينتمي هذا الغرض إلى فضlءs‏ Jlأlnuء .System.Drwaing‏ 
يمكننا تمثيل الألوان بعدة طرق: 
٠ه‏ استخدام الطريقة (عں1ط ۲٠٥٣,‏ ع,ل۲,هطماة A۸68)‏ حيث يمكننا تمثيل الألوان بإعطاء قيم للمركبات اللونية الثلاث التي 
تعبر عن شدة اللون الأحمر و الأخضر و الأزرق إضافة إلى الشفافية. تأخذ كل من هذه المركبات قيمة صحيحة بين 0 
و255. 
باستخدام أسماء الألوان مسبقة التعريف في .×٤٣‏ 
باستخدام أسماء الألوان المستخدمة في ا11۷ حيث يتم تعيين قيمة الألوان كسلسلة محرفية باستخدام الصف 
.ColorTranslator‏ 
المثال التالي يوضح الطرق المختلفة لتعيين خاصة اللون: 


أما ضمن الملف ×مءه فيتم استخدام الصيغة: 


أو صيغة مماثلة لتلك المستخدمة في ا11۷ و التي تعبر عن اللون كرقم مكتوب بصيغة ستعشرية: 


الخطوط: 


توفر الخاصية ۴۵۸۲ مر جعاً إلى غرض ۴0 ٣ا٤۴‏ المعرف ضمj‏ فخضlءs System.Web.UI.WebControls «lai‏ حیث 
يملك كل غرض ۴١١۲1١0‏ مجموعة من الخصائص التي تحدد اسمه وحجم الخط والنمط المستخدم. 


الخاصة الوصف 
اسم الخط المستخدم 

مصفوفة تحتوي أسماء مجموعة من الخطوط. 

يقوم المستعرض بالتحقق من توفر الخطوط حسب الترتيب 
الذي ترد فيه ضمن هذه المصفوفة.و يقوم باستخدام أول 
خط مطابق للخطوط الموجودة على حاسب الزبون و يدعمها 
المستعرض. 

تعبر هذه الخاصة عن حجم الخط حيث يمكن أن يمثل بقيمة 
نسبية أو مطلقة. 
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Bold, Italic, Strikeout, Underline, overline‏ خصائص منطقية تطبق النمط المحدد عند إسناد القيمة 
u۵‏ لليها. 


يمكن إسناد قيم إلى هذه الخصائص ضمن الرماز بالصيغة: 


كذلك یمکن تحدید حجم الخط باستخدام النمط ٤1ہ :۴0,٤0‏ 


أُما في ملف ×م5ه. فنستخدم الصيغة: 


عند استخدام نوع خط غير متوفر لدى الزبون يتم استخدام الخط التلقائي للمستعرض. 
لذا من المفضل استخدام أكثر من نوع خط مفصولة بفاصلة ءلكي يتم اعتماد تلك الخطوطء وحسب الترتيب» في حال عدم وجود الخط 
المطلوب على حاسب الزبون كما يظهر في المثال: 


<asp:TextBox Font-Names="Verdana,Tahoma,Arial" Text="Size Test" ID="txt" runat="server" /> 


الترکیز (کںcu٥؟):‏ 


بعكس عناصر تحكم 1711 توفر عناصر تحكم الوب الخاصة ()ا٥ه۴.‏ 

عند تصيير الصفحة يتم البدء عند عنصر التحكم الذي يملك التركيز. 

بالإضافة إلى إمكانية استدعاء الطريقة ()15١٥۴ءيمكن‏ ضمن ملف ×مءهءاستخدام الواصفة اء ۴٤u1ه؟‏ م( الخاصة بتأشيرة 
النموذج: 


لا يمكن للعناصر التي لا تقبل الدخل مثل 1ءط1a‏ أن تحصل على التركيز و لكن يمكن استخدام لخاصة AssociatedContro11D‏ 
لتحديد عنصر إدخال مرتبط وبهذه الطريقة يتم تمرير التركيز من عنصر تحكم 14061 إلى عنصر التحكم المرتبط كما يوضح المتال 
التالى: 
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تمکن 48۲.٤1‏ من تحديد أحد الأزرار في الصفحة كزر تلقائي. يتم ضغط هذا الزر تلقاتياً لدى ضغط زر الإدخال من لوحة 


يتم تحديد الزر التلقائي ضمن تأشيرة عنصر التحكم باستخدام الواصفة ١0)ا‏ 18٠۴م(‏ كما في المثال: 
١ n | [ a=" 0 e‏ 2 


يمكن أن يكون الزر التلقائي أي من عناصر التحكم التي تتبنی الواجھة 18u tt٥ ۸٣٥٥٣٤٥1‏ مثل عناصر تحکم 
«Button , LinkButton, ImageButton‏ 


عناصر تحكم القوائم: 


تتضمن عناصر تكم llتوpÛl‏ عناص .istBox „, DropDownList , CheckBoxList , RadioButton , Bulleted List‏ تعمل 
جميع هذه العناصر مبدئيا بنفس الطريقة و لكن يتم تصييرها بشكل مختلف. فعلى سبيل المثال يتم تصيير عنصر التحكم ×80(ك1i‏ 
كقائمة مستطيلة تظهر عدة بنود في حين يظهر عنصر تحكم ائ1امس0 مها( العنصر المختار فقط » أما بالنسبة لعنصر تحكم 
stاCheckBox‏ فهو مشابه لعنصر تحکم ×180ء11 بفرق کون کل بند یتم تصییر ہ كعنصر C٥Chec)80×‏ . 

و أخيراً عنصر تحكم ءء٥81‏ و هو العنصر الوحيد الذي لا يسمح باختيار عناصر لكن يتم تصيير البنود ضمنه كتسلسل من 
العناصر المرقمة أو المسبوقة بتعداد نقطي. 

توفر جميع عناصر تحكم القائمة خاصة × ل[لء†٥ه1م؟‏ التي تحدد البند المختار. مثلاً إذا تم اختيار البند الأول تكون قيمة هذا الدليل 
مساوية للصفر. 


عناصر تحكم القائمة متعددة الاختيار: 


تسمح بعض عناصر تحكم القائمة باختیار أکثر من بiد YJ)‏ تدم RadioButtonList g DropDownList‏ هذه الخاصة). 
يتم تفعيل الاختار المتعدد باسناد القيمة انئمرnãة List.SselectionMode.Multiple‏ إلى llخۈاصة SelectionMode‏ . 
يسمح عنصر التحكم عندها باختيار أكثر من بند من القائمة وذلك بضغط زر ٥)۲1‏ ونقر البنود المراد اختيارها. 

يتم الوصول إلى معلومات البنود المختارة من خلال المجموعة كطه)1. 

يمكن تحديد العناصر التي تم اختيارها عبر المرور من خلال حلقة على جميع عناصر هذه المجموعة و التحقق قيمة الخاصة 
List]tem.Selected‏ لکل عنصر فیها. 


يوضح المثال التالي استخدام عنصر تحكم †ئ80×[1)ء٠C1‏ للحصول على خيارات اللغات التي قام المستخدم باختيارها. 
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3 CheckBoxTest - Microsoft Internet Explorer 0K | 


F% 
File Edt Yew Favorites Tools Help OQ Bac. - I 


Address €] hte: localhast:2915/WebContrals/CheckêoxT ast, aspx اا‎ 
Choose your farorite programming languages: 


mle 

Oo 

C# 

O Visual Basic 6.0 
W VB.NET 

O Fascal 


Tou chose: 
C# 


€ Local intranet 


يوضح النص التالي التأشيرات المستخدمة ضمن ملف ×م8ك: 
Page Language="C#" AutoEventWireup="true"‏ @%< 
CodeFile="CheckListTest.aspx.cs" Inherits="CheckList Test" %>‏ 
<html xmins="http://www.w3.org/1999/xhtml">‏ 
<head runat="server">‏ 
<title>CheckBoxTest</title>‏ 
</head>‏ 
<body>‏ 
<form runat="server">‏ 
<div>‏ 
Choose your favorite programming languages:<br /><br />‏ 
<asp:CheckBoxList ID="chklst" runat="server" /><br /><br />‏ 
<asp:Button ID="cmdOK" Text="OK" OnClick="cmdOK_Click" runat="server" />‏ 
<br /><br />‏ 
<asp:Label ID="lbIResult" runat="server" />‏ 
</div>‏ 
</form>‏ 
</body>‏ 
</html>‏ 


أما النص البرمجي الذي ستتم إضافته للتنقل بين بنود القائمة عند نقر زر 0 فيكون على الشكل: 
public partial class CheckListTest : System.Web.UI.Page‏ 
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protected void Page_Load(object sender, EventArgs e) 


{ 
if (!this.IsPostBack) 


{ 

chklist.ltems.Add("C"); 
chklst.ltems.Add("C++"); 
chklist.ltems.Add("C#"); 
chklst.ltems.Add("Visual Basic 6.0"); 
chklist.ltems.Add("VB.NET"); 
chklIst.ltems.Add("Pascal"); 


} 
protected void cmdOK_Click(object sender, EventArgs e) 


IbIResult. Text = "You chose:<b>"; 
foreach (Listltem Istltem in chklist.ltems) 


if (Istltem.Selected == true) 


{ 
// Add text to label. 
IbIResult. Text += "<br />" + Istltem. Text; 


} 

IbIResult. Text += "</b>"; 
} 
} 


عنصر تحكم قائمة التعداد النقطي أو الرقمي: 


يقابل عنصر التحكم هذا تأشيرة <انا> أو <آه> من جهة المخدم. 
يملك عنصر التحكم هذا مجموعة من الخصائص تمكن من عملية التحكم بشكل إظهار هذا العنصر. 


الجدول التالي يظهر بعض هذه الخصائص: 
الخاصة الوصف 

8۴ تحدد هذه الخاصة نمط القائمة سواء كانت رقمية أم قائمة 
تسلسل أبجدي أو قائمة أرقام رومانية أو بأشكال مثل الدائرة › 
القرص » المربع 
Bela‏ | في حال تم إسناد قيمة #ع2 ”٣0ں‏ إلى الخاصة 
ماtSty Bı‏ يمكن تحديد الصورة التي ستستخدم للتنقيط 
ضمن هذه الخاصة. 
FirstBulletNumber‏ تستخدم هذه الخاصة مع التعداد الرقمي لتحديد العدد أو الحرف 
الذي سييداً الترقيم عنده. 
118۷۷۷86 | تحدد هذه الخاصة طريقة تصبير بنود القائمة (كنص أو كإرتباط 
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لتمكين الاستجابة للحدث )1cاً٣.۸٥)٤tں8‏ نقوم باسناد القيمة 8u †)0١‏ ہ1 إلى الخاصة .Display mode‏ 
يتم تحديد البنود التي تم اختيارها ضمن القائمة باستخدام غرض BulletedListEve{Args‏ . 
المثال التالي يوضح نص مقبض الحدث: 


3 Untitled Page - Microsoft Inter net Cxplorer 
File. Edit Yjew Favorites Tools Help 


ûddress 
Eullct atrlca: 


Notmet 
nbered 
Lowerû pha 
Ipper Alpha 
LowerRormai 
UpperEoman 
Disc 

Lircle 


HALE 


wustom [naze 


FM mo Gn Fp 


| ي‎ Lacalintranêt 


عناصر تحكم الجداول: 


يتم بناء عناصر تحكم الجداول من هرمية من الأغراض حيث يحتوي كل غرض جدول غرض ٠W‏ ۸ء1طه٠‏ أو أكثر ويحتوي كل 


غرض ٥W‏ 16۸طھ٦‏ بدورہ »غرض 11٥٥٤٥1طھ۲‏ أو آکثر. 
يحتوي کل غرض [61٥1ط14‏ عناصر تحكم ۸8۴.٤81‏ الأخرى التي تقوم بإظهار المعلومات ضمن هذه الخلية من الجدول. 
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يوضح الشكل التالي هذه الهرمية و علاقة الأغراض ٤1‏ ط12 W‏ 180ء25٦‏ 611٥٤18ط۲4‏ بعضها ببعض : 


A Sample Table Object 
(2 Rows, 3 Columns) 


TablêRow 


Tablelell Tablelell Tablelell 


HTML ûr Sêrvêr HTML or Server HTML ûr Sêrvêr 
Controls Controls Controls 


TableRow 


TableCell TableCe11 TableCe11 


HTML or Server HTML or Server HTML OT SETVET 
Controls Controls Controls 


مثال 


يمكننا إتباع نفس الآلية لإنشاء جدول بشكل ديناميكي . الشكل التالي يمثل تطبيق بسيط. يستخدم هذا التطبيق القيم المدخلة عبر العلب 


النصية اتحديد عدد الصفوف و عدد الأعمدة للجدول المطلوب إنشاؤه.كما و يحدد عنصر تحكم ×0 ec)8طC‏ تفعيل أو إلغاء إحاطة 
الخلايا باطار. 
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3 Table Test - Microsoft Internet Explorer -EK 


FF 
Fie. Ed. Yiew Favorites Tools Help 


Eows: ۳ 
Put Border dzound Cells 


Create 


| Example Cell (O 0) Example Cell (0,1) Example Cell (0.2) 
Erample el ITD Etatmdlê el f1, [Frarmple ell 1,2) 
1 َ 

| Ezarnple Cell (2 O) Eraraple Cel (2,1) (Ezample Cell (2,2) 


as ٣ ن‎ 
| Erarmple ell (40) (Ezample el fA, 1) Example Cell (4,2) 


_arzal inkraak‏ له 


يوضح رماز صفحة ×مه التالي كيفية إضافة عنصر تحكم ٥1ا14‏ عناصر تحكم 1١×80×‏ و عنصر تحكم ×80)ءعطC‏ إضافة 


:Butt0۸ إلى عنصر تحکم‎ 
<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="TableTest.aspx.cs" Inherits=" Table Test" %> 
<html xmins="http://www.w3.org/1999/xhtml"> 
<head runat="server"> 
<title> Table Test</title> 
</head> 
<body> 
<form runat="server"> 
<div> 
Rows: 
<asp:TextBox ID="txtRows" runat="server" /> 
&nbsp;Cols: 
<asp:TextBox ID="txtCols" runat="server" /> 
<br /><br /> 
<asp:CheckBox |D="chkBorder" runat="server" 
Text="Put Border Around Cells" /> 
<br /><br /> 
<asp:Button |D="cmdCreate" OnClick="cmdCreate_Click" runat="server" 
Text="Create" /> 
<br /><br /> 
<asp:Table |ID="tbI" runat="server" /> 
</div> 
</form> 
</body> 
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</html> 


لا يحتوي عنصر تحكم الجدول 10ط14 أية صفوف أو خلايا عند إنشاءه» لذلك نحن بحاجة لتضمين تأشيرات أخرى ضمن تأشيرة 
يظهر المثال التالي جدول يحتوي صف واحد بخلية واحدة: 


<asp:Table |ID="tbl" runat="server"> 

<asp:TableRow ID="row" runat="server"> 

<asp:TableCell ID="cell" runat="server">A Sample Value</asp:TableCell> 
</asp:TableRow> 

</asp:Table> 


لن نقوم باستخدام التأشيرات و بناء الجدول بشكل مباشر في مثالنا. 

ستكون مهمة بناء محتوى الجدول ديناميكياً ملقاة على عاتق الرماز الخاص بمقبض حدث تحميل الصفحة و مقبض حدث ضغط الزر 
.Create‏ 

سيتم تحديد سماكة إطار الخلايا و نمط الإطار ضمن مقبض حدث تحميل الصفحة وتوليد الصفوف والخلايا ومحتواها ضمن مقبض 
حدث ضغط الزر ع2٥۲).‏ 


public partial class TableTest : System.Web.UI.Page 
protected void Page_Load(object sender, EventArgs e) 


/I Configure the table's appearance. 

/I This could also be performed in the .aspx file 
/l or in the cmdCreate_Click event handler. 
tbl.BorderStyle = BorderStyle.Inset; 
tbl.BorderWidth = Unit.Pixel(1); 


} 


protected void cmdCreate_Click(object sender, EventArgs e) 


// Remove all the current rows and cells. 

/I This is not necessary if EnableViewState is set to false. 
tbl.Controls.Clear(); 

int rows = Int32.Parse(txtRows. Text); 

int cols = Int32.Parse(txtCols. Text); 

for (int row = 0; row < rows; rFOWw++) 


/I Create a new TableRow object. 
TableRow rowNew = new TableRow(); 
/I Put the TableRow in the Table. 
tbl.Controls.Add(rowNew); 

for (int col = 0; col < cols; col++) 


// Create a new TableCell object. 
TableCell cellNew = new TableCell(); 
cellNew. Text = "Example Cell (" + row.ToString() + ","; 
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cellNew. Text += col.ToString() + ")"; 
if (chkBorder.Checked) 


{ 
cellNew.BorderStyle = BorderStyle.Inset; 
cellNew.BorderWidth = Unit.Pixel(1); 


} 
/I Put the TableCell in the TableRow. 
rowNew.Controls.Add(cellNew); 


ر 
ر 
ر 
} 


يستخدم النص السابق غرض المجموعة ٥٥٣٤٣01‏ لإضافة أغراض عناصر التحكم الأبناء. تتوفر الخاصة التي تعيد المجموعة 
ئا في جميع عناصر التحكم الحاوية. 


يبين النص التالي كيفية الاستفادة من غرض المجموعة ك[ه ٣٥٣٤٣‏ لإضافة عناصر تحكم أخرى ضمن الخلايا مثل عنصر تحكم 


.Label şİ Image 


// Create a new TableCell object. 

cellNew = new TableCell(); 

// Create a new Label object. 

Label IbINew = new Label(); 

lbINew. Text = "Example Cell (" + row.ToString() + "," + col. ToString() + 
")<br />", 

System.Web.UI.WebControls.Image imgNew = new System.Web.UI.WebControls.lImage(); 
imgNew.lImageUrl = "cellpic.png"; 

/I Put the label and picture in the cell. 

cellNew.Controls.Add(lbINew); 

cellNew.Controls.Add(imgNew); 

/I Put the TableCell in the TableRow. 

rowNew.Controls.Add(cellNew); 


إن أهم ما يجعل عنصر تحكم 16طة1 مميزاً كون كل خلية ضمنه هي غرض متكامل المزايا. يمكن التعامل مع كل خلية بشكل منفصل 
و تحديد سماكة أو لون للإطار أو للنص داخلها و إضافة المحتوى المرغوب فيه. 
يوضح الشكل التالي واجهة التطبيق بعد التعديل: 
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3 Table Test - Microsoft Internet Explorer 


Files Edit View Favorites Tools Help @Q Bark 2 اج‎ Bl E @ 


Address 3 http: localhost: 1405WebZontralsT ablePictures, aspx 


Rows: |4 


#1 Put Border Around Cells 


Ezatnple ell fO,0} Example Gel (O, 1) Example Sel (O,2) 
ت ل ت‎ 


Ezatnple Cell (1,0) Ezatmple Cel (1, 1) (Example Sel (1,2) 
ت 3 ت‎ 


Ezarmple Cell {2,0} Example Cel (2, 1} Example Sel (2,2) 
ك 3 ك‎ 


Ezample Cell (4,0) Ezample Cell (3, U) (Ezample Zell (8,2) 
ك ك ا‎ 


2] Local intranet 


الأحداث الخاصة بعناصر تحكم الوب و عملية إعادة الإرسال الآلیة t٥ ٥)8 ck‏ ںA:‏ 


بيتا في الجلسة السابقة محدودية الأحداث التي تقدمها عناصر تحكم الوب ووضحنا أنها توفر حدثين فقط )ءا٣$6۲۷6۲‏ لعناصر التحكم 

التي تتضمن إعادة الإرسال و الحدث عع,2 1٣۲١۷ء5‏ الخاص بالعناصر التي تقبل الإدخال مثل اامہ!. 

نعلم أن الرماز في ۸8۴.٤1‏ يعالج على المخدم ثم يتم إرسال الخرج كصفحات ۲۷1[ إلى الزبون. 

يمكن معالجة الأحداث التي تسبب إعادة إرسال الصفحة مثل حدث ءنا٣.‏ حيث يتم إطلاق الحدث و تنفيذ الرماز في مقبض الحدث 

من جهة المخدم. 

لكن ماذا عن الأحداث التي لا تسبب إعادة إرسال الصفحة؟ 

كيف سيتم تفعيل الاستجابة للحدث؟ 
في الواقع هناك طريقتان : 

1- الانتظار حتى عملية الإرسال التالية أي تجميع الأحداث لحين القيام بإرسال الصفحة . 
مثلاً لن يحدث شيء بشكل فوري عند اختيار عنصر جديد من القائمة عند تعديل اختيار عنصر من قائمة 
Se1ected]ndexChanged‏ و لكن عندما ينقر الزبون زر اطا لإرسال الصفحة يتم إطلاق حدثين الأول خاص بنقر الزر 
والثاني الخاص بالتعديل على العنصر المختار من القائمة. 
2- الحل الآخر لهذه المشكلة هو استخدام ايار .AutoPostBack‏ 
يجبر هذا الخيار عناصر التحكم على إعادة إرسال الصفحة فورأً عند تلقي حدث ما من جهة الزبون. 
يتم بهذه الطريقة ارسال الصفحة و تنفيذ الرماز الخاص بمقبض الحدث على المخدم ثم يتم إعادة نسخة جديدة من الصفحة إلى 
الزبون تتضمن أية تعديلات سببها إطلاق الحدث. 
يؤدي استخدام الحل الذي یعتمد )182ء0٥ Auto‏ في كثير من الأحيان إلى الحصول على صفحات أقل استجابة نظراً للتأخير 
المصحوب بعملية إعادة إرسال الصفحة مرارأ و تكراراً عند الاستجابة لكل حدث (الحل في هذه الحالة قد يكون باستخدام مكونات 
„(AJAX‏ 
تدعم جميع عناصر التحكم التي تقبل الإدخال ائخاصة .AutoPostBack‏ 
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يوضح الجدول التالي الأحداث الخاصة بعناصر تحكم وب الأساسية : 


عناصر تحكم الوب التي تدعم هذا الحدث | عملية إعادة الإرسال مفعلة بشكل دائم 


True : 
Button, ImageButton Click 


False 
TextBox TextChanged 


False : 
CheckBox, RadioButton CheckedChanged 


False DropDownList, ListBox, 


CheckBoxList, RadioButtonList SelectedIndexChanged 


فيما يلي شكل يبين تسلسل معالجة عملية إعادة إرسال الصفحة بغرض تحديد المرحلة التي يتم عندها ظهور كل حدث من الأحداث: 


Universal Knowledge Solutions s.a.1. 
86 


إنشاء غرض الصفحة من ملف ×ميج | 


ظهور حدث )1ہ۴age.1‏ 


المحفوطة في ع†ه†؟ View‏ 


إعادة تأهيل عناصر التحكم بالمعلومات من القيم | 
ظهور حدث تحميل الصفحة 
Page.Load‏ 


مٿل حدث ) Click‏ ڪ (Change‏ 


Page.Pre Render ظھور حدث‎ 


State 


State 


ظھور حدٿ Page. n1]044‏ 
يتم تحرير غرض معه۴ من الذاكرة 
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کیف يعمل حدث 4c)‏ طostہP:‏ 


تقوم ApP.N٤1‏ بتولید رjla javascript‏ من جهة الزبون و تنشاأً دالة خاصة باسم )ء182٤٥0۴‏ _ لتحسس الحدث (من جهة 
الزبون) و تأمين عملية إرسال الصفحة. الرماز التي تولد الدالة يشبه التالي: 


يبين الشكل التالي كيف تحدث عملية إعادة الإرسال الآلي للصفحة: 


أحداث من هة الخدم 


Javascripisw 


إعانة إرسال صفحة الوب 


doPostBack() 
ا‎ 
Client 


لنفهم أكثر كيف تعمل الأحداث في عناصر تحكم الوب لا بد لنا من فهم أعمق لدورة حياة الصفحة إذا افترضنا أنه تم تعيين الخاصة 
AutoPostBack‏ إلى عuا1‏ ستكون المراحل التي تمر بها الصفحة هي التالية: 
يتم تفعيل دالة امإإءvasهز‏ kعaطstمممكd_‏ من طرف الزبون و يتم إعادة إرسال الصفحة إلى المخدم. 
تتم إعادة إنشاء غرض الصفحة باستخدام ملف ×مpكه.‏ 
تقوم ۸8.N٤1‏ باستعادة معلومات الحالة من حقول #اهاء ه۷16 المخفية و تحدث عناصر التحكم وفقاً لتلك المعلومات 
المخزنة. 
يتم إطلاق حدث تحميل الصفحةل102.ءع۴a.‏ 
يتم إطلاق حدث عع C11‏ المناسب لعنصر التحكم (ليس هناك ترتيب محدد لتنفيذ الأحداث في حال أكثر من عنصر تحكم). 
يتم إطلاق حدث 44ه0املاءعه۴ و يتم تصيير الصفحة و تحويل مجموعة عناصر التحکم إلى صفحة HTML‏ 
يتم إرسال الصفحة الجديدة إلى الزبون. 
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سنستخدم هذا المتال لنقوم بصقل مجموعة المعارف التي تم الحصول عليها خلال هذه الجلسة. 
يوضح الشكل التالي الواجهة المراد الحصول عليها للتطبيق حيث يمكن اختيار لون الخلفية و نمط الخط و حجمه و نمط الإطار 
إضافة إلى الصورة و نص التهنئة. 

Û hittp:Jflocalhast: 3352/GreetingCar dMMaker/GreetingCar Maker .as px - Microsoft Internet Explorer - 6 


#7 


Fila Edit Yi Favorites Tools Help (a Bark جا‎ r E E ر و‎ Searth بال‎ Favorites ا‎ 0 


iddress 3 http: localhost: 3352 arresting CardMaker fareetingZardMaker , aspx ا‎ 


Zhoose a background color: 


Lhoose a font: 


Times Mew Forman م‎ 


Specify a numeric font size: 


Lhoose a border style: 
@ None 

O Double 

O solid 


ddd the Default Picture 


Enter the greeting text below: 


3 Done لر‎ Local intranet 
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Û http:Jilocalhost: 3352/GreetingCar dMakerfGreetingCar dMaker .as px - Microsoft Internet Explorer - 8 


Fila Edit Yiew Favorites Tools Help O Bark + ھ‎ E O O sear < Favorites a 2 Iv 


iddress 3 http: localhost: 3352 NareetingCardMaker fareetingZardMaker , aspx 


LZhoose a background color: 

Happy 
Choose a font: Birthday, and 
Yerdana 


Specify a numeric font size: Ma Ny NO re 


Choose a border style: 
O None 

@ Double 

O solid 


٤ 


3 


WM Add the Default Picture 


Enter the greeting text below: 


Happy Birthday, and many 
mMOEFE 


يمتل الرماز التالي الرماز ضمن صفحة ×مطءه للحصول على التصميم الظاهر ضمن الشكل السابق: 
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Choose a font:<br /> 

<asp:DropDownlList ID="IstFontName" runat="server" Width="194px' 
Height="22px" /><br /><br /> 

Specify a numeric font size:<br /> 

<asp:TextBox |D="txtFontSize" runat="server" /><br /><br /> 
Choose a border style:<br /> 

<asp:RadioButtonList ID="IstBorder" runat="server" Width="17 7px" 
Height="S59px" /><br /><br /> 

<asp:CheckBox |D="chkPicture" runat="server" 

Text="Add the Default Picture"></asp:CheckBox><br /><br /> 
Enter the greeting text below:<br /> 

<asp:TextBox |D="txtGreeting" runat="server" Width="240px" Height="85px" 
TextMode="MultiLine" /><br /><br /> 

<asp:Button |D="cmdUpdate" OnClick="cmdUpdate_ Click" 

runat="server" Width="71 px" Height="24px" Text="Update" /> 

</div> 

<!-- Here is the card: --> 

<asp:Panel |ID="pnlCard" runat="server" 

Width="339px" Height="481 px" 

HorizontalAlign="Center"><br />&nbsp; 

<asp:Label ID="lblGreeting" runat="server" Width="256px" 
Height="150px" /><br /><br /><br /> 

<asp:lmage ID="imgDefault" runat="server" Width="212px" 
Height="160px" /> 

</asp:Panel> 

</form> 

</body> 

</html> 


أما الرماز في الخلفية: 
public partial class GreetingCardMaker : System.Web.UI.Page‏ 


protected void Page_Load(object sender, EventArgs e) 


{ 
if (!this.IsPostBack) 


/I Set color options. 
IstBackColor.ltems.Add("White"); 
IstBackColor.ltems.Add("Red"); 
IstBackColor.ltems.Add("Green"); 
IstBackColor.ltems.Add("Blue"); 
IstBackColor.ltems.Add("Yellow"); 

/I Set font options. 
IstFontName.ltems.Add("Times New Roman"); 
IstFontName.ltems.Add("Arial"); 
IstFontName.ltems.Add("Verdana"); 
IstFontName.ltems.Add("Tahoma"); 

/I Set border style options by adding a series of 
/I Listltem objects. 

Listltem item = new Listltem(); 

/I The item text indicates the name of the option. 
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item. Text = BorderStyle.None. ToString(); 

/I The item value records the corresponding integer 
/I from the enumeration. To obtain this value, you 
// must cast the enumeration value to an integer, 
// and then convert the number to a string so it 

/I can be placed in the HTML page. 

item.Value = ((int)BorderStyle.None). ToString(); 
/I Add the item. 

IstBorder.ltems.Add(item); 

/I Now repeat the process for two other border styles. 
item = new Listltem(); 

item. Text = BorderStyle.Double.ToString(); 
item.Value = ((int)BorderStyle. Double). ToString(); 
IstBorder.ltems.Add(item); 

item = new Listltem(); 

item. Text = BorderStyle.Solid. ToString(); 
item.Value = ((int)BorderStyle.Solid).ToString(); 
IstBorder.ltems.Add(item); 

/I Select the first border option. 
IstBorder.Selectedlndex = 0; 

/I Set the picture. 

imgDefault.lImageUrl = "defaultpic.png"; 


protected void cmdUpdate_Click(object sender, EventArgs e) 


{ 

/I Update the color. 

pnlCard.BackColor = Color.FromName(IstBackColor.Selectedltem. Text); 
/I Update the font. 

l\blGreeting.Font.Name = IstFontName.Selectedltem. Text; 

if (Int32.Parse(txtFontSize. Text) > 0) 


{ 
lbIGreeting.Font.Size = 
FontUnit.Point(Int32.Parse(txtFontSize. Text)); 


/I Update the border style. This requires two conversion steps. 
/I First, the value of the list item is converted from a string 

/I into an integer. Next, the integer is converted to a value in 

/I the BorderStyle enumeration. 

int borderValue = Int32.Parse(IstBorder.Selectedltem.Value); 
pnlCard.BorderStyle = (BorderStyle)borderValue; 

/I Update the picture. 

if (chkPicture.Checked) 


imgDefault.Visible = true; 
} 
else 


imgDefault.Visible = false; 


} 
// Set the text. 
lblGreeting. Text = txtGreeting. Text; 
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تحسين التطبيق : 


نلاحظ في الرماز السابق أن قائمة الخطوط و الألوان تمت إضافتها يدويا. 
يمكن الاستحصال على معلومات الخطوط و الألوان المثبتة من خلال غرض المجمو عة ]nsta1]!ed ۴0٤٣011101‏ كما يمكن 
استخدام الطريقة Enum .GetNames(typeof(KnowCo|0r))‏ للحصول على قائمة بأسماء الألوان: 


using System.Drawing; 
using System.Drawing. Text; 


// Get the list of available fonts, and add them to the font list. 
InstalledFontCollection fonts = new InstalledFontCollection(); 
foreach (FontFamily family in fonts.Families) 


IstFontName.ltems.Add(family.Name); 


} 


Zhoosa a font nama: 


A4calemy Engraved _ET 5 


4rial Rounded YT Bold 
ودع اہا۔ا اواش‎ 
BernhardF ashion BT 


/I Get the list of colors. 

string[] colorArray = Enum.GetNames(typeof(KnownColor)); 
IstBackColor.DataSource = colorArray; 
IstBackColor.DataBind(); 


/I Set border style options. 

string[] borderStyleArray = Enum.GetNames(typeof(BorderStyle)); 
IstBorder.DataSource = borderStyleArray; 

IstBorder.DataBind(); 
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توليد البطاقة آليا 


يتم توليد البطاقة آلياً سنقوم بإسناد القيمة ۲۲۴ إلى الخاصة )ء518١۴٥۸‏ وإضافة رماز تحديث البطاقة إلى مقبض حدث 


Change وحدٿ‎ Click 
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3 hittp:/Ilocalhost:3352/GreetingCar dMMaker/GreetingCar dAMaker 2.as px - Microsoft Internet Explorer - 28 


Fila Edit Yjew Favorites Tools Help O eax چا‎ 5 El „Û Search ke Favorites 2 


Address 2 http: fflacalhast: 3352 areekingCardMaker areetingZardMakera , aspx 


Lhoose a background color: 
Light Goldenrod’ allow ك‎ 
Choose a foreground ftext? color: 
Black 


Zhoose a font name: 


Arafamy Fngravardl | FT bi 


Specify a font size! 
1 


Lhonose a border style: 
ONotSet O Double 
ONone O Groove 
Opotted  @Ridge 
ODashed  OInset 
O solid O outset 


W add the Default Picture 


Enter the greeting text below: 
Happy Eirthday ! 


Local intranet‏ لر 
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الفصل التاسع 
إدارة الحالة 


يتعرف الدارس في هذا الفصل على: 

لماذا نحتاج إلى إدارة الحالة 

إدارة الحالة ضمن صفحة وحيدة باستخدام المجموعة Vi W5)‏ 
طرق نقل المعلومات بين الصفحات 

استخدام الكعكات 

لخدام اة ارف الاسشا 

استخدام محددات 81ل المطعمة 

استخدام حالة الجلسة 

حالة التطبيق 


لط ڂ دن طط ئ ئل لأ م 


إدارة الحالة: 


تعد إدارة الحالة من أهم عناصر الاختلاف بين البرمجة الخاصة بتطبيقات سطح المكتب و برمجة الوب و السؤال هو كيف سيتم 
تخزين المعلومات خلال فترة حياة التطبيق. 

يمكن لهذه المعلومات أن تكون بسيطة كاسم المستخدم أو أكثر تعقيدا كالمحتوى الكامل لعربة تسوق ضمن تطبيق متجر بيع الكتروني. 
ففي حالة تطبيقات سطح المكتب لا داعي للقلق بشأن إدارة الحالة فالذاكرة متوفرة و لا حاجة للقلق إلا على مستخدم وحيد بينما تختلف 
القصة في تطبيقات الوب حيث يدخل آلاف المستخدمين بشكل متزامن لتشغيل التطبيق على نفس المخدم عبر اتصال 111۲۴ الذي لا 
يمكن حفظ الحالة .هذه الظروف تجعل من المستحيل تصميم تطبيق بنفس الطريقة التقليدية المعتمدة في تطبيقات سطح المكتب . 

في هذه الجلسة سوف نتعرف على كيفية استخدام مزايا إدارة الحالة في ۸8۴.٤1‏ لتخزين المعلومات بعناية و باتساق. سنقوم 
باستعراض مجموعة من خيارات التخزين التي تتضمن 5 س۷1 » غرض الجلسة » الكعكات كذلك سذأخذ بعين الاعتبار كيفية 
انتقال المعلومات من صفحة إلى أخرى باستخدام الإرسال بين الصفحات و غرض ١g‏ ۲1٤ySاQue.‏ 


مشكلة الحالة في تطبيقات الوب: 


قد يبدو موقع ۸8۴.٤٣‏ احترافي و كأنه تطبيق مستمر العمل » و لكن هذا الانطباع وهمي .ففي طلب الوب يتصل المستخدم بمخدم 
الوب و يطلب صفحة» عند تسليم الصفحة المطلوبة يتم إلغاء الاتصال و يقوم مخدم الوب بإهمال جميع المعلومات المتعلقة بالزبون. في 
الوقت الذي يستلم فيه الزبون الصفحة يكون البرنامج قد توقف عن العمل و لا يوجد أي معلومات باقية ضمن ذكرة مخدم الوب. 
ViewState‏ 


المجموعة S٤٤8‏ س۷1 هي أحد الطرق الشائعة لتخزين المعلومات. 
تستخدم S6‏ س۷1 حقول الحقول المخفية التي تقوم ۸5۴.٤1‏ بإدراجها أوتوماتيكياً في ملف 1۲۷1 الناتج بعد تصيير الصفحة. 
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تعتبر 6ا٤5‏ س۷1 المكان الأنسب لتخزين المعلومات التي تستخدم في عمليات إعادة الإرسال المتكررة. 

رأينا في الجلسات السابقة كيفية استخدام هذه الطريقة للحفاظ على المعلومات. مثلاً إذا تم تغيير قيمة نص سيتم الاحتفاظ بالمعلومات آلياً 
(التفعيل للخاصة ءاهاw5Sع1 E41۷‏ تلقائي) باستخدام 5)4١‏ س۷1 بهذه الطريقة يتم ضمان بقاء التعديلات التي تم إجراؤها على 
الصفحة و عدم عودة القيم إلى القيم البدئية التي تم تحدديها في زمن التصميم. 

في جميع الأحوال لا يقتصر عمل 8ه ؟ س۷1 على عناصر التحكم.إذ يمكن لرماز صفحة الوب إضافة معلومات بشكل مباشر إلى 
W6‏ الخاصة بصفحة الوب و إستعادتها لاحقا بعد إعادة إرسال الصفحة. 

تتضمن أنماط البيانات التي يمكن تخزينها ضمن ۷50ء۷1 جميع أنماط البيانات من البسيطة و حتى الأغراض المخصصة التي 
ينشؤها المطور ضمن الصفحة. 


:۷1 eW State غرض المجموعة‎ 


توفر الخاصة ه5 س۷1 المعلومات الحالية للصفحة. هذه الخاصة هي مثيل من صف المجمو عة ع84ء Sta)‏ .إن صف State Bag‏ 
هو مجموعة مفهرسة بمعنى أن كل عنصر ضمن المجموعة مخزن بشكل منفصل باستخدام اسم مميز من نمط سلسلة محرفية. 
لنأخذ هذا الرماز على سبيل المثال : 


يقوم الرماز السابق بوضع القيمة 1 (عدد صحيح يحتوي الرقم 1) ضمن مجموعة #أه)S ۷1W‏ ويقوم بإعطائها الاسم الوصفي 
."Counter"‏ 

إذا لم يكن هناك أي عنصر بالاسم ١٤ا٥٥"‏ ستتم إضافة العنصر بشكل آلي.أما إذا كان هناك عنصر قد تم تخزينه تحت اسم 
"unter"‏ فسیتم استبداله. 

عند استرجاع القيمة المخزنة نقوم باستخدام الاسم و لا بد أيضاً من تحويل القيمة المستعادة إلى نمط البيانات المطلوب باستخدام صيغ 
التحويل. 

إن عملية التحويل مهمة لأن المجموعة اه8 س۷1 تقوم بتخزين العناصر كأغراض أساسية مما يسمح لها بالتعامل مع عدة أنماط 
بيانات. 

فيمايلي الرماز اللازم لاسترجاع قيمة العداد المخزنة تحت الاسم 016۲ من ءاه)5سء۷1 و تحويلها إلى عدد صحيح: 


فیما يلي مثال یستخدم lزnجمy‏ عة ViewState‏ ليقوم بتخزين عدد المرات التي تم ضغط زر فیها. 


في هذا المثال عدم وجود أي صيغة لإدارة الحالة سوف تبقى قيمة العداد و بشكل دائم مساوية 1. 
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Untitled Page - Microsoft Internet Explorer 


Fil Edit Yim Favorites Tonls Felp O Bark r 


Address Î] http: Hlocalhast:2416Chapter111simplerounter ,aspx 


lncrermen: 


ounter: Ö 


جعل View State‏ آمنة: 


يتم تخزين معلومات 5)١‏ س۷1 كما ذكرنا ضمن حقول مخفية من الشكل: 


قد يخطر إلى أذهاننا أن القيمة غير المفهومة لعةا5 س۷1 هي ناتج عملية. هذا غير صحيح» إذ أن معلومات wS‏ ع۷1 يتم 
تحويلها إلى سلسة محرفية للقاعدة 64 وهي نمط خاص من السلاسل المحرفية. 
يعتمد هذا النمط في وثائق ا111 كونه لا يتضمن أية محارف من المحارف الإضافية. 


إذاً بإمكان أي مخترق و بعملية هندسة عكسية معرفة محتوى معلومات 8اه؟ س٠1‏ في ثواني. 


لحماية المعلومات من التعديل يمكن الاعتماد على تفعيل خوارزميات التشويش و هي عملية إنشاء لحزمة إضافية من البيانات تم 
تشكليها من تطبيق نمط من اختبار المجموع الحسابي و الاستعانة بمفتاح سري و إلحاق كتلة البيانات الناتجة بالقيمة الاساسية ل 
ViewState‏ . 

عند إعادة إرسال الصفحة يتم التأكد آلا من التطابق بين محتوى عاه51 س۷1 ومطابقة كتلة التحقق المضافة مع الكتلة التي يتم إعادة 
توليدها باستخدام القيمة الحالية لعاه†wS‏ ء۷1 . 

قد يلجا بعض المطورون أحياناً لإزالة تفعيل هذه الخاصة وذلك عند التعامل مع مزرعة من المخدمات حيث لا يمكن التحقق محتوى 
۷16 لعدم توافر مفتاح التشويش السري الذي ولده أحد المخدمات عند المخدمات الأخرى. 
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لإزالة تفعيل التشويش يتم تعديل قيمة الو اصفة M12‏ ع enab1e View Sa‏ ضمن مز :machine.config yİ web.config‏ 


كما يمكن حل هذه المشكلة بضبط المخدمات لتستخدم نفس مفتاح التشويش. 


خصوصية معلومات م)S)4 eW‏ ۷1: 
حتى باستخدام مفتاح التشويش فإن محتوى البيانات سيظل مقروءاً من قبل المستخدم (وهذا أمر طبيعي في الحالة العامة) و لكن ماذا 
إذا احتوت المجموعة اه5 سه۷ على معلومات لا بد من إيقائها غير معروفة فلا بد حينها من تعيين الواصفة 
ViewStateEncryptionMode‏ إلى القيمة sره‏ سا۸ وذلك ضمن الرماز الخاص بف :machine.config ڃİ web.config‏ 


لدينا ثلاث خيارات بالنسبة لإعدادات التشفير الخاصة ب )Auto Never Always) View Sta‏ وكما هو واضح من أسماء تلك 
الخيارات» الخيار اا۸ يحدد كون التشفير لن يحصل ما لم يطلب أحد العناصر على هذه الصفحة بشكل خاص.يقوم عنصر التحكم 
بطلب التشفير حال تلقيه الطريقة .Page.RegisterRequires ViewStateEncIy p01)‏ أما في حال الخیار e۷٥۲‏ فلن تتم عملية 
تشفير محتوى المجموعة ٥)ه)5 ۷1W‏ مما يوفر عبء هذه العملية. 


المحافظة على متغيرات العناصر 


للمحافظة على متغيرات العناصر يكفي حفظ هذه المتغيرات إلى الغرض ها5 ۷٠W‏ ثم استعادته عند إعادة تحميل الصفحة. 
المتال التالي يوضح هذه الفكرة من خلال استعادة قيمة نص علبة نصية تم حفظه. 
يتم حفظ المعلومات المراد المحافظة عليها ضمن مقبض حدث ۲ء ۸ء ۸ء۴۲.ععه۴ ثم إعادة تعيينها ضمن مقبض الحدث e.1044ع۲۴a‏ 
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Î Untitled Page - Microsoft Internet Explorer - 28 


File 3Ji Wew Fawortes Toons Help wv 


Address 3 http: Hlocalhas::2+16Chapter 11 Fraser YerMembers, aspx َ 


Thiz iz a teat of the ?re3PryYENeNbErF3.a3pX page 


Local intranet‏ ل 


public partial class PreserveMembers : Page 
{ 
/l A member variable that will be cleared with every postback. 
private string contents; 

protected void Page_Load(Object sender, EventArgs e) 


{ 

if (this.IsPostBack) 
{ 
/I Restore variables. 

contents = (string)ViewState["contents"]; 
} 


protected void Page_PreRender(Object sender, EventArgs e) 


/I Persist variables. 
ViewState["contents"] = contents; 


} 


protected void cmdSave_Click(Object sender, EventArgs e) 


/I Transfer contents of text box to member variable. 
contents = txtValue.Text; 


txtValue. Text = "": 


} 


protected void cmdLoad_Click(Object sender, EventArgs e) 
{ 
// Restore contents of member variable to text bOX. 
txtValue. Text = contents; 


ر 
1 
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يجب الائتباه في هذا السياق إلى عدم تخزين إلا ما كان ضرورياً من المعلومات باستخدام هذه التقنية. لأن هذا سيؤدي إلى ازدياد حجم 


الصفحة النهائية بشكل كبير و بالتالي إطالة زمن عملية انتقال الصفحة. 


تخزين الأغراض المخصصة 


يمكنك تخزين أغراضك المخصصة كما تقوم بتخزين المتحولات الصحيحة أو سلاسل المحارف ضمن غرض ماه†؟ س۷1 لكن في 
حالة الأغراض لا يمكن تخزينها ما لم يتم تحويلها إلى سياق من البايتات ليصبح من الممكن إرسالها ضمن الحقول المخفية التي 
تستخدمها ۷1٥wW 5٤٤٥‏ لإرسال البيانات. 

تسمى هذه العملية سلسلة و لا يمكن عادة بدونها وضع الأغراض التي تكون غير مسلسلة بطبيعتها ضمن غرض ۷1W S46‏ . 
لجعل الأغراض قابلة للسلسلة يكفي إضافة الواصفة [ء1طه14117إع؟] قبل تعريف الصف. 

المثال التالي يستخدم هذه الطريقة لتخزين معلومات غرض ۳۴١‏ 80ا٣‏ ضمن غرض ع)S4س‏ م۷1 . 


[Serializable] 

public class Customer 
{ 
private string firstName; 
public string FirstName 
{ 
get { return firstName; } 
set { firstName = value; } 
} 
private string lastName; 
public string LastName 
{ 
get { return lastName; } 
set { lastName = value; } 


public Customer(string firstName, string lastName) 


FirstName = firstName; 
LastName = lastName; 
} 
} 


private string lastName; 
public string LastName 


{ 


get { return lastName; } 
set { lastName = value; } 


public Customer(string firstName, string lastName) 


FirstName = firstName; 
LastName = lastName; 
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بعد إضافة الواصفة 1طه1zاه1إه؟‏ أصبح بالإمكان تخزين المعلومات ضمن عأهSسه۷1.‏ 


عند استعادة معلومات الغرض المخزن لا بد من تحويلها قسرياً إلى نمط البيانات الخاص بالصف ١٥١‏ 0†ءCu:‏ 


عند استخدام أغراض .N.E۲‏ يمكنك أن تعرف ما يمكن تخزينه ضمن ۷1٨٠514١‏ بالاطلاع على ملف المساعدة الخاص بتعريف كل 
من هذه الأغراض فإذا وجدت الواصفة ع1طه1zاهذإهS‏ يمكنك التأكد بأن هذا الغرض يمكن تخزينه ضمن عاه†WSه۷1:‏ 


نقل المعلومات بين الصفحات 


إن أحد أهم العناصر التي تحد من فائدة S٤١‏ س۷1 هي كونها مرتبطة بشكل كامل بصفحة محددة» وحين يتم طلب صفحة أخرى 
تزول كل المعلومات المخزنة في هذا الغرض. 
تطرح N٤1‏ .۸8۴ لغرض نقل المعلومات بين الصفحات عدة حلول هي: 

استخدام تقنية إعادة الإرسال عبر الصفحات 

استخدام الغرض Que۲y5)۲118‏ 

استخدام الكعكات 

استخدام أغراض الجلسة 


استخدام غرض التطبيق 


استخدام تقنية إعادة الإرسال بين الصفحات: 


إن عملية إعادة الإرسال بين الصفحات هي امتداد لآلية إعادة الإرسال التي قمنا باستخدامها. 
يكمن الفارق في أن عملية الإرسال تتم إلى صفحة أخرى بشكل كامل متضمنة جميع المعلومات الخاصة بهذه الصفحة. 
تبدو هذه التقنية بسيطة و لكنهاء إذا لم تستخدم بعنايةء قد تقود إلى سيناريو من مجموعة صفحات مرتبطة ببعضها بشكل كبير يصعب 
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تحسينها و تطويرها. 

يتم دعم هذه الآلية باستخدام الخاصة 1ا )ء184٠۴‏ التي المعرفة في الواجهة البرمجية 0٣٤۲٥1‏ ٣٥ا18‏ والتي توفرها عناصر 
ilتھكp .ImageButton,LinkButtonKBUtton‏ 

لاستخدام هذه التقنية يكفي اسناد قيمة المحدد الخاص بعنوان الصفحة المراد إرسال المعلومات إليهاء إلى الخاصة ۲1ا P۴0st8 ac)‏ 
ضمن أحد عناصر التحكم السابقة. 

عند النقر على الزر سيتم إعادة إرسال الصفحة مع القيم من جميع عناصر الإدخال إلى الصفحة الهدف. 

المثال التالي يوضح عملية إرسال الصفحة ×مءه.1٥ع C٠١۴4‏ الحاوية على نموذج يتضمن عنصر تحكم علبة نص وزر إلى 
lنصفحة :CrossPage2.aspx‏ 


<%@ Page Language="C#" AutoEventWireup="true" CodeFile="CrossPage1.aspx.cs" 
Inherits="CrossPage1" %> 

<html xmins="http://www.w3.org/1999/xhtml"> 

<head runat="server"> 

<title>CrossPage'1 </title> 

</head> 

<body> 

<form id="form1" runat="server" > 

<div> 

First Name: 

<asp:TextBox ID="txtFirstName" runat="server"></asp:TextBox> 
<br /> 

Last Name: 

<asp:TextBox ID="txtLastName" runat="server"></asp:TextBox> 
<br /> 

<br /> 

<asp:Button runat="server" ID="cmdPost" 
PostBackUrl="CrossPage2.aspx" Text="Cross-Page Postback" /><br /> 
</div> 

</form> 

</body> 

</html> 


نلاحظ أن الصفحة ×مءه.eمع۴2 ross‏ لا تحتوي أي رماز في الخلفيةء فقط تم تعيين الواصفة االا)ءه 18ء٠۴‏ إلى القيمة 
CrossPage2.aspx‏ 
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3 CrossPage1 - Microsoft Internet Explorer -)F * 


Fils Edit view Farorikes Tools Felp Bat: 


Aires 3 HtEp: localhost: 184EStateManagementyzrossPagel .a5p» 


First Name! Joey 
Last Name: | SMYÎE | 


Lross-Page Postback 


Lacal intranet‏ ر 


بعد أن يتم إرسال المعلومات إلى الصفحة الهدف تستطيع هذه الصفحة الوصول إلى معلومات الصفحة المرسلة عن طريق الغرض 
Previ0usP2ge‏ الذي مرجع إلى الصفحة السابقة: 
public partial class CrossPage2 : System.Web.UI.Page‏ 


protected void Page_Load(object sender, EventArgs e) 
if (PreviousPage != null) 


lbllnfo. Text = "You came from a page titled " + 
PreviousPage. Title; 


نلاحظ هنا بأننا قمنا بالتحقق من الصفحة السابقة لنضمن أن الطلب على الصفحة ×مءه.2٥ع۴4ءءه]٤‏ تم من خلال صفحة أخرى 
وليس مباشرة. 
لكننا لن نتمكن من الاستفادة بشكل كامل من غرض الصفحة الذي قمنا باستعادته ما لم يتم تحويله قسرياً إلى نمط الصف المناسب وهو 
في :CrossPage1 liil‏ 

protected void Page_Load(object sender, EventArgs e) 


{ 


CrossPage1 prevPage = PreviousPage as CrossPage1; 
if (prevPage != null) 


/I (Read some information from the previous page.) 


ر 


كما يمكن اللجوء إلى تعيين قيمة موجه ءمر1ءع۴4ءuه¡رءإ۴‏ ضمن الصفحة الهدف إلى نمط البيانات المتوقع لهذا الغرض كما في 
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الرماز التالي: 


<%@ PreviousPageType VirtualPath="~/CrossPage1.aspx" %> 


ولكن حتى بعد اللجوء إلى أحد الطريقتين التاليتين لن تتمكن من الوصول إلى عناصر التحكم التي تحتويها الصفحة لأن هذه العناصر 
غير متاحة للوصول عبر الصفوف الأخرى. 
لحل هذه المشكلة يمكنك إما إنشاء خصائص عامة تعيد مرجع للعناصر المطلوبة أو إنشاء طرق أو خصائص تعيد فقط ما يمكن أن 
تحتاجه الصفحات الأخرى من هذه الصفحة. 
الرماز التالي يعرض هذه الفكرة: 

public partial class CrossPage1 : System.Web.UI.Page 


public string FullName 


get { return txtFirstName. Text + " " + txtLastName. Text; } 


ر 
1 


وضمن رماز الصفحة ×طءه.2ءع۴4ءءهC۲‏ يمكننا استخدام الخاصة التي قمنا بإنشائها: 
protected void Page_Load(object sender, EventArgs e)‏ 
if (PreviousPage != null)‏ 
lbllnfo. Text = "You came from a page titled " +‏ 
PreviousPage. Title + "<br />";‏ 
CrossPage1 prevPage = PreviousPage as CrossPage1;‏ 
if (prevPage != null)‏ 


lbllnfo. Text += "You typed in this: " + prevPage.FullName; 


ملاحظة: تعتبر طريقة إعدة الإرسال عبر الصفحات طريقة مفيدة و لكنها قد تقود إلى صفحات أكثر تعقيداً و بالأخص في الصفحات 
التي تستقبل طلبات من أكثر من صفحة.لذلك يفضل اعتماد هذه الطريقة في السيناريو الذي يتم تمرير المعلومات بين صفحتين محددتين 


السلسلة المحرفية الخاصة بالاستعلام QueryString‏ 


من المقاربات الأخرى التي يمكن استخدامها عند الرغبة بإرسال بتمرير المعلومات بين الصفحات استعمال السلسلة المحرفية الخاصة 
بالاستعلام ضمن محدد المصدر الموحد 0R۸1ل.‏ 
تستخدم هذه المقاربة بشكل كبير ضمن محركات البحثء فمن المشاهد المألوفة رؤية عنوان ضمن حيز العنوان في المتصفح من 
الشكل: 
http://www.google.ca/search?qz=organic+gardening‏ 
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ذلك الجزء من محدد 81ل اللاحق لإشارة الاستفهام هي 6۲/5٤۲1١8‏ . ففي المثال أعلاه يتم تعيين قيمة المتحول ¶ إلى القيمة 
."organic+gradening"‏ 
الميزة الأساسية في هذه المقاربة التي تستخدمها ع١1٣ا5لإمںQ‏ أنها لا تشكل أي عبء على المخدم و لكن من وجهة تعتبر محدودة 
للعديد من الأسباب منها: 
المعلومات التي يمكن نقلها بين الصفحات بهذه الطريقة محصورة بالسلاسل المحرفية البسيطة التي لا بد أن تحتوي محارف 
UR‏ النظامية. 
تظهر المعلومات التي يتم نقلها بشكل واضح للمستخدم و لأي شخص يتنصت على الانترنت. 
يمكن للمستخدم أن يقوم بتبديل المعلومات ضمن سلسة محارف الاستعلام يدوياً. ويقوم بإدخال معلومات مختلفة لا يقبلها 
البرنامج أو لا يستطيع حماية نفسه منها. 
تحدد العديد من المستعرضات طول السلسة المحرفية الخاصة بالاستعلام (عادة بين K81‏ و 28). لهذا السبب» لا يمكن 
وضع كمية كبيرة من المعلومات ضمن سلسة محارف الاستعلام و التأكد من دعم جميع المستعرضات. 
ولكن بالرغم من هذا تبقى طريقة إضافة المعلومات إلى سلسة محارف الاستعلام مفيدة جداً و بالأخص في التطبيقات المرتبطة 
بقواعد البيانات حيث يمكن ربط إظهار مجموعات مختلفة من النتائج من خلال تمرير معلومات تحدد السجلات المراد إعادتها. 
تستخدم العديد من تطبيقات التجارة الالكترونية هذه التقنية (فقط لاستعراض المنتجات و ليس للشراء). 
لبه من فخزين ال مات كن فة ارف الاك درا 3 لاق غ A976‏ مو عة مسةك أر نكن اهاد 
الطريقة Response. Redirec†)‏ أو عنصر ت>كp HyperLink‏ مخصص: 


يمكننا إرسال أكثر من متحول مع قيمه بشرط فصلها بالإشارة & : 


الوصول إلى المعلومات التي تم إرسالها باستخدام سلسة محارف الاستعلام 


لحسن الحظ» توفر ۸58۶.٤1‏ مجموعة خاصة ضمن الغرض ءء٩٥۸‏ يمكن من خلالها الوصول إلى المعلومات التي تم إرسالها 
عبر سلسة محارف الاستعلام. اسم هذه المجموعة هو 1٤‏ ۲1)؟Que1yS:‏ 


يتم استرجاع جميع قيم المتحولات كسلسلة محرفية و يقع على عاتق المطور تحويلها إلى نمط البيانات المطلوب. 

تتم فهر سة القيم ضمن المجمو عة 5S)۲1١8‏ ۷إ »ا0 باستخدام اسماء المتحولات المستعملة ضمن سلسة محارف الاستعلام. 

مثال: 

يقوم المتال التالي باستخدام مقاربة سلسلة محارف الاستعلام لإظهار المعلومات المرتبطة بدليل العنصر الذي تم اختياره من عنصر 
تحكم قائمة في أحد الصفحات ضمن صفحة ثانية. 
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E Untitlad Page - Microsoft Inlernet Explorer 
Ele Edt View Favories Took Hep € EER 


Address 


Econo Sofa 
Supreme Leaher Drapery 


Threadbare Carpet 


TIcira Finiah Jacuzzi 


ll Shewe full details 


Yew lnfarmatior 


Local intranet 


أُما النص البرمجي للصفحة المرسلة فهو : 
public partial class QueryStringSender : System.Web.UI.Page‏ 


{ 
protected void Page_Load(Object sender, EventArgs e) 


{ 
if (!this.IsPostBack) 


/I Add sample values. 
Istltems.ltems.Add("Econo Sofa"); 
Istltems.ltems.Add("Supreme Leather Drapery"); 
Istltems.ltems.Add("Threadbare Carpet"); 
Istltems.ltems.Add("Antique Lamp"); 
Istltems.ltems.Add("Retro-Finish Jacuzzi"); 


} 
protected void cmdGo_Click(Object sender, EventArgs e) 


if (Istltems.Selectedlndex == -1) 


IblError. Text = "You must select an item."; 


} 


else 


/I Forward the user to the information page, 

/I with the query string data. 

string url = "QueryStringRecipient.aspx?"; 

url += "ltem=" + Istltems.Selectedltem. Text + "&"; 
url += "Mode=" + chkDetails.Checked.ToString(); 
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A Untitled Page - Microsoft Inter nel Explorer 


El Edt Yew Favorites Torls Heh Qer - O - A & | 


2dFess |8] fetp:ffbcalhast:24 1 efthapter 11 Juery r ngRaripiert. apitîterzanli e 2L amaêMoce=Tme WÎ 


Item: Antique Lamp 
Show Full Record: True 


ترمیز :U RL‏ 
مشكلة المحارف غير المسموحة هي أحد المشاكل التي ترتبط باستخدام مقاربة سلسلة محارف الاستعلام. 
يجب أن تكون جميع المحارف المستخدمة أحرف أو أرقام أو أحد المحارف الخاصة بما يتضمن ($ - _ .+ !*.() ). 
تقبل بعض المستعرضات (۲١10۲م×٤‏ أعnصإعاما)‏ محارف إضافية أخرى. 
هذه المحارف غير المدعومة من العديد من المستعرضات مما يجعل استعمالها غير مأمون. 
بعض المحارف لها معنى خاص متل إشارة & التي تستخدم كما ذكرنا لفصل قيم المتحولات. كذلك الأمر بالنسبة لإشارة (*) التي 


تعتبر بديلاً عن استخدام محرف الفراغ. و إشارة (#) التي تستخدم لتحديد إشارة مرجعية ضمن صفحة الوب. 
إذا أردنا إرسال بيانات تحوي هذه المحارف» سيحصل نقص في البيانات ناتج عن ترجمة هذه المحارف بشكل مختلف. 
لتفادي هذه المشكلة نلجاً إلى تشفير النصوص قبل وضعها ضمن اRل.‏ 
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نستخدم لهذا الغرض تشفير خاص يقوم بتحويل المحارف الخاصة إلى نمط مقبول ضمن محدد ا۸. 

يعتمد هذا التشفير على استبدال المحارف الخاصة بإشارة % متبوعة برقم من خانتين. 

مثلاً يمكن تشفير المحرف & بشكل %26 

الاستثناء الوحيد لهذه القاعدة هو محرف الفراغ التي يمكن استبداله ب %20 أو بإشارة +. 

تستخدم لغرض عملية التشفير الطريقة 0۲181٥04 ٥)(‏ في حين يتم استخدام الطريقة 0۲10٥٥04 e)(‏ لفك التشفير. 
تتبع الطرق السابقة lلصڙ HttpServerUtitlity‏ . 

يوضح المتال التالي استخدام هذo‏ lلÛطرa :(UrlDecode«Ur1Encode)‏ 


نلاحظ في هذا المثال السابق أننا لم نقم بتشفير المحرف & لأننا نريد منه أن يعمل كمحرف خاص يدمج المتحولين معأً. 
تقوم ASP.NET‏ تلقائياً بفك تشفير السلسلة في حال الوصول إليها باستخدام الغرض 1ع eu‏ ۸ باستخدام المجمو عة Que۲5۲118‏ 
لذلك و في الحالة السابقة لا داعي لاستخدام عملية فك تشفير باستخدام الطريقة #ل0٥٥10٣لاعلى‏ السلسلة التي تم استقبالها. 


الكعكات 
يعد استخدام الكعكات أحد الطرق الأخرى الشائعة لحفظ الحالة. 
تساعد الكعكات على تخزين المعلومات تم إعادة استخدامها. 


الكعكات هي عبارة عن ملفات صغيرة يتم إنشاؤها على القرص الصلب للزبون (أو ضمن الذاكرة المؤقتة لمستعرض الوب). 
من أهم الميزات في الكعكات: 

٠ه‏ كونها تعمل بشكل شفاف دون علم المستخدم بالمعلومات التي تحتاج إلى تخزين 

٠‏ إمكانية استخدامها من قبل أي صفحة ضمن التطبيق 

٠ه‏ الاحتفاظ بها يتم لفترة أطول مما يسمح لاستخدامها في تخزين المعلومات بين الزيارات بمدى أطول 


أُما عيوب هذه الطريقة فهي تماثل تلك المتعلقة باستخدام سلسلة محارف الاستعلام بمعنى: 
٠‏ إمكانية التعامل مع سلاسل المحارف البسيطة فقط 
٠‏ يمكن الوصول إليها و قراءتها من قبل المستخدم 


كل ما سبق يجعل خيار استخدام الكعكات خيار غير مناسب للمعلومات المعقدة والتي تعتبر الخصوصية من الأولويات أو تحتاج إلى 
تخزين كم كبير من المعلومات. 

يقوم بعض المستخدمين بإلغاء دعم الكعكات في المستعرضات التي يستخدمونها أو يقومون بشكل يدوي بمسح ملفات الكعكات مما يخلق 
مشكلة للتطبيقات التي تستخدم هذه المقاربة. 

لاستخدام الکعکات لا بد من استيراد فضاء الأسماء .System.Net‏ 

يعتبر التعامل مع الكعكات عملية سهلة حيث يوفر كل من غرضي اكعuءR‏ و م٥كئر0ميمR‏ مجمو عة باسم .Cookies‏ 

يتم اسناد قيمة إلى الكعكة باستخدام الغرض عءء«٠0مءع۸‏ و استعادة القيمة بواسطة الغرض اكع 4u‏ ۸. 
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نقوم بإنشاء غرض HttpCookie‏ 
٠‏ نقوم بتأهيل هذا الغرض بالمعلومات المطلوب تخزينها على شكل ثنائيات اسم و قيمة كما يظهر في الرماز التالي: 


/I Create the cookie object. 

HttpCookie cookie = new HttpCookie("Preferences"); 
/I Set a value in it. 

cookie["LanguagePref"] = "English"; 

/I/ Add another value. 

cookie["Country"] = "US"; 

/I Add it to the current web response. 
Response.Cookies.Add(cookie); 


إذا تم إنشاء كعكة ما بهذه الطريقة تظل قيمة الكعكة موجودة لحين إغلاق المستعرض. 
خلال ذلك الوقت يتم إرسال هذه الكعكة مع كل طلب على الوب. 
لتحديد عمر الكعكة تستخدم الخاصة ١١1۲م×8‏ كما في الرماز التالي: 
/I This cookie lives for one year.‏ 
cookie.Expires = Date Time.Now.AddYears(1);‏ 


يمكننا استعاد قيمة الكعكات من خلال غرض nllجموg‏ عة :Requested.Cookies‏ 


HttpCookie cookie = Request.Cookies["Preferences"]; 

/I Check to see whether a cookie was found with this name. 
/I This is a good precaution to take, 

/I because the user could disable cookies, 

/l in which case the cookie will not exist. 

string language; 

if (cookie != null) 


language = cookie["LanguagePref"]; 


لحذف كعكة نقوم باستبدالها بكعكة أخرى تمتلك تاريخ انتهاء سابق. 
الرماز التالي يوضح هذه التقنية: 


HttpCookie cookie = new HttpCookie("LanguagePref"); 
cookie.Expires = Date Time.Now.AddDays(-1); 
Response.Cookies.Add(cookie); 
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مثال على استخدام الكعكات 
في المثال التالي سيتم استخدام الكعكات لتخزين اسماء الزبائن و إظهار رسالة ترحيب في حال وجد هذا الاسم مسبقا. 


‘3 Untitled Page - Microsoft Internet Explorer - 88 
Els Edt view Favorites Inols Hep QBak 7” ا اھا کا ۆ‎ 


3 hEEp ff lacalhast: 2418 Zhapter 1 1 CookisExanıpla ,a5px* ي‎ 


Address 


Cookie Found. 


Welcome, Matthew 


Manel] GeneGonke J) 


يكون رماز هذه الصفحة من الشكل: 
public partial class CookieExample : System.Web.UI.Page‏ 


{ 
protected void Page_Load(Object sender, EventArgs e) 


HttpCookie cookie = Request.Cookies["Preferences"]; 
if (cookie == null) 


lbIlWelcome. Text = "<b>Unknown Customer</b>"; 


} 


else 


IbIlWelcome. Text = "<b>Cookie Found.</b><br /><br />"; 
IbIlWelcome. Text += "Welcome, " + cookie["Name"]; 


} 
protected void cmdStore_Click(Object sender, EventArgs e) 


/I Check for a cookie, and only create a new one if 
/I one doesn't already exist. 
HttpCookie cookie = Request.Cookies["Preferences"]; 
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حالة الجلسة 


تصل معظم التطبيقات إلى مرحلة تصبح فيها احتياجات التخزين أكثر تعقيدا. 
وفي العديد من الحالات لا يمكن استخدام الكعكات أو إرسال المعلومات عبر ع١۲1)؟رإمںQ‏ و بالأخص عند الحاجة إلى تخزين 
الأغراض المخصصة أو الوصول إلى عناصر قواعد البيانات أو في الحالات التي تفرض فيها طبيعة التطبيق الحاجة إلى درجة أمان 
عالية. 
استخدام غرض حالة الجلسة هو الحال الأمثل في هذه الحالة. 
تعد إدارة الحالة باستخدام غرض الجلسة أحد أهم المزايا في ۸8۴.٤1‏ للأسباب التالية: 
٠ه‏ توفر هذه التقنية إمكانية تخزين أي نمط من البيانات على ذاكرة المخدم 

تكون البيانات المخزنة ضمن غرض الجلسة محمية لأنه لا يتم نقلها إلى الزبون 

ترتبط معلومات غرض الجلسة بجلسة واحدة محددة 

يتم تخصيص غرض جلسة مستقل لكل زبون 

يمكن للزبون تخزين بياناته ضمن غرض الجلسة 
من الامثلة الشائعة لإدارة حالة الجلسة هو تطبيق سلة التسوق حيث يمكن للمستخدم تخزين معلومات المشتريات أثناء التسوق والتجوال 


بين أكثر من صفحة. 


تتبع وملاحقة الجلسات: 


تستخدم N٤1‏ .م۸ معرف فريد بطول 120 بت لملاحقة الجلسات. 

يتم توليد أرقام هذه الجلسات بخوارزمية خاصة. 

تضمن هذه الخوارزمية عشوائية كافية تمنع أي محاولة لتخمين أواستخدام تقنيات الهندسة العكسية لتحديد معرف الجلسة لزبون ما. 
لذلك فالجزء الوحيد من معلومات الجلسة الذي يتم تبادله بين المخدم و الزبون هو ذلك الخاص بالمعرف الفريد لهذه الجلسة. 

عندما يرسل الزبون معرف الجلسة تقوم ٤1‏ .مء بالبحث عن الجلسة الموافقة. 

تقوم 1٤p.Nء۸‏ بوضع المعلومات التي تم الاستحصال عليها باستخدام معرف الجلسة تلقائياً ضمن مجموعة خاصة ليتم من خلالها 
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الوصول إلى المعلومات المخزنة. 

يعتمد هذا السيناريو كما ذكرنا على أن يزود يتقدم الزبون بمعرف جلسة صالح مع كل طلب. يمكن تحقيق هذا الغرض بطريقتين: 

1. استخدام الكعكات: في هذه الحالة يتم إرسال معرف الجلسة ضمن كعكة خاصة باسم (ASP.NET Session1d)‏ .تقوم 
1 .م بإنشاء هذه الجلسة آلياً عندما يتم استخدام المجموعة ١0ووم؟‏ الخاصة بإدارة الحالة. تعد هذه الطريقة هي 
الطريقة الافتراضية في العمل. 
استخدام محددات 1 0R‏ المعدلة: يتم في هذه الحالة نقل معرف الجلسة من خلال محددات 0۸1ل معدلة (تسمى مطعَمة 
أحياناً). تمكن هذه الطريقة من إدارة حالة الجلسة ضمن بيئة الزبون التي لا تدعم الكعكات. 

لا تأتي الميزات والمرونة التي تقدمها حالة الجلسة بشكل مجاني. فبالرغم من كونها توفر تقنية تتجاوز العديد من نقاط الضعف التي 

تعاني منها الطرق الأخرى.فهي تجبر المخدم على تخزين معلومات إضافية في الذاكرة. 

رغم كون المعلومات التي تخزن عادة ضمن غرض الجلسة صغيرة لكنها تصبح عبء حقيقي يؤثر على الأداء بشكل كبير عندما يرتفع 

عدد الزبائن الذين يحاولون الوصول إلى الموقع. 


استخدام حالة الجلسة: 


يمكن التعامل مع حالة الجلسة من خلاJî‏ |زلصز .Web.SessionState.HtpSession State‏ 
يتوفر هذا الصف من خلال الغرض المبّيت ضمن صفحة الوب 101كءع؟. 
تستخدم إدارة حالة الجلسة صيغة مشابهة لتلك التي قمنا باستخدامها مع غرض مأه†؟س۷1. 


تعتبر حالة الجلسة عامة لكامل التطبيق لكن لمستخدم وحيد. 
تحذف معلومات الجلسة في مجموعة من الحالات منها: 
إذا قام المستخدم بإغلاق وإعادة تشغيل المستعرض 
إذا قام المستخدم بالوصول إلى التطبيق باستخدام نافذة أخرى للمستعرض سيتم التعامل مع هذا الوصول كمستخدم جديد 
بمعرف مختلف 
إذا انقضى زمن محدد دون أي تفاعل مع التطبيق من قبل مستخدم محدد.يتم تحديد زمن انتهاء الصلاحية بتحديد قيمة الخاصة 
4اا و التي سنأتي على شرحها لاحقا 
٠‏ إذا قام الرماز بإنهاء حياة الجلسة قسرياً باستخدام الطريقة 0۸ل«0طا۸ 
تبقى الجلسة في الحالتين الأولى والثانية ضمن الذاكرة على المخدم لأن المخدم لا يملك أي فكرة عن كون الزبون قد أغلق الجلسة 
أو فتح نافذة أخرى. ستتجمع أغراض S٥١‏ هذه ضمن الذاكرة بانتظار انتهاء صلاحيتها. 


HttpSessionState زص‎ 


الجدول التالي يوضح أهم الخصائص والطرق الخاصة بالصف :HttpSessio "State‏ 
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العنصر الوصف 

Count‏ تعيد هذه الخاصة عدد العناصر ضمن مجموعة ضمن غرض 
المجموعة الخاص بالجلسة. 

IsCookieless‏ تحدد آلية تتبع معرف الجلسة سواء باستخدام الكعكات أو 
محددات 1[ ]8R‏ المعدلة. 

في حال إسناد القيمة ءء[ه] لهذه الخاصة سيتم استخدام 
الكعكات. 

IsNewSession‏ في حال إسناد القيمة )٠٠#‏ لهذه الخاصة سوف يتم التعامل مع 
أي جلسة في التطبيق على أنها جلسة جديدة ة لن تحاول 
".مء متابعتها بل سيتم إنشاء جلسة جديدة مع كل طلب. 
توفر قيمة مرقمة تحدد کیف ستخزن ۸8۲.N٤1‏ معلومات 
حالة الجلسة.يتم تحديد نمط التخزين هذا بناء على الإعدادات 
المعينة ضمن ملف web.config‏ 

SessionIlD‏ تعيد هذه الخاصة سلسة محرفية تتضمن معرف الجلسة للزبون 
الحالي. 

Timeout‏ تحدد هذه الخاصة الزمن المنقضي بالدقائق قبل حذف حالة 
الجلسة في حال لم يتم تلقي أي طلب من الزبون خلال هذه 
الفترة. 

يمكن تغيير قيمة هذه الخاصة برمجيا لتمكين إطالة أة إنقاص 
عمر حالة الجلسة حسب الحاجة. 

Abandon(O‏ تقوم هذه الطريقة بإلغاء الجلسة الحالية بشكل فوري و تحرير 
الذاكرة التي تشغلها. 

يفضل استخدام هذه التقنية ضمن صفحة تسجيل الخروج لضمان 
استعادة الذاكرة التي تحجزها حالة الجلسة بأسرع وقت. 

تقوم هذه الطريقة بإزالة جميع العناصر من غرض الجلسة لكن 
تقوم بالمحافظة على معرف الجلسة. 


مثال على استخدام حالة الجلسة: 


سنستخدم في هذا المثال حالة الجلسة لتخزين عدة أغراض مفروشات. 
فيما يلي الرماز الخاص بتعریف الصف ۲۵ں ٣۲ں۴:‏ 
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public decimal Cost; 

public Furniture(string name, string description, 
decimal cost) 

{ 

Name = name; 

Description = description; 

Cost = cost; 

} 

1 


يتم إنشاء ثلاث أغراض مفروشات في المرة الأولى التي يتم فيها تحميل الصفحة وتخزن ضمن حالة الجلسة. 
بإمكان المستخدم اختيار أحد المفروشات من قائمة. 
عند اختيار أحد المفروشات تتم استعادة الغرض الموافق للعنصر المختار و إظخار معلوماته. 


3 Untitled Page - Microsoft Internet Explorer EEG 
Ele Edt Liew Fgwrrites Inols Help gı - O `7 El A f Seam 


Adds Î] Hp: | lacahast:241 Ef hapterl 1 Bessirît ateEx ample.aqpz 


Session ID: rywSr3b4knskos 45 2cOOfO55 
Number of Objects: 3 

Mode: InProc 

Is Cookieless:; False 

Is New: False 

Timeout (minutes j; 20 


fl ore Inîarmm ation‏ ا 


Mame: Pioneer Table 
Manufacturer: Heritage Unit 
Cast: BBB. 


Retr Cabinet 


J cca irtraret 


فيما يلي الرماز الخاص بالمثال: 


public partial class SessionStateExample : System.Web.UI.Page 


{ 
protected void Page_Load(Object sender, EventArgs e) 


{ 
if (!this.IsPostBack) 


// Create Furniture objects. 

Furniture piece1 = new Furniture("Econo Sofa", 
"Acme Inc.", 74.99M); 

Furniture piece2 = new Furniture("Pioneer Table", 
"Heritage Unit", 866.75M); 

Furniture piece3 = new Furniture("Retro Cabinet", 
"Sixties Ltd.", 300.11M); 

// Add objects to session state. 
Session["Furniture1"] = piece1; 
Session[""Furniture2"] = piece2; 
Session[""Furniture3'""] = piece3; 

// Add rows to list control. 
Istltems.ltems.Add(piece1.Name); 
Istltems.ltems.Add(piece2.Name); 
Istltems.ltems.Add(piece3.Name); 

} 
// Display some basic information about the session. 

/l This is useful for testing configuration settings. 
IbISession. Text = "Session ID: " + Session.SessionlD); 
IbISession. Text += "<br /Number of Objects: "; 
lbISession.Text += Session.Count. ToString(); 

lbISession. Text += "<br />Mode: " + Session.Mode.ToString(); 
IbISession. Text += "<br />Is Cookieless: "; 
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lIbISession.Text += Session.IsCookieless. ToString(); 
lbISession. Text += "<br />Is New: "; 

lIbISession.Text += Session.IsNewSession. ToString(); 
IbISession. Text += "<br /> Timeout (minutes): "; 
lbISession. Text += Session. Timeout. ToString(); 

} 


protected void cmdMorelnfo_Click(Object sender, EventArgs e) 


{ 


if (Istltems.Selectedlndex == -1) 


IbIRecord. Text = "No item selected."; 


} 


else 


// Construct the right key name based on the index. 
string key = "Furniture" + 

(Istltems.Selectedlndex + 1). ToString(); 

// Retrieve the Furniture object from session state. 
Furniture piece = (Furniture)Session [key]; 


// Display the information for this object. 

IbIRecord. Text = "Name: " + piece.Name; 

IbIRecord. Text += "<br />Manufacturer: "; 

IbIRecord. Text += piece.Description; 

IbIRecord. Text += "<br />Cost: " + piece.Cost. ToString("c"); 
} 
} 


جعل حالة الجلسة أكثر قابلية للتوسع 


يواجه مطورو الوب مشكلة أداء عند محاولة تخزين كمية كبيرة من المعلومات ضمن حالة الجلسة وبالأخص عند تز ايد الاستخدام 
المتزامن للتطبيق من قبل عدد كبير من المستخدمين. 

يمكن في هذه الحالة استخدام قاعدة البيانات لتخزين معلومات الجلسة. 

تمكن هذه الطريقة من تخزين كمية كبيرة من البيانات و لفترات طويلة (أسابيع أو حقى أشهر). 

تؤثر هذه الطريقة على الأداء بسبب الاضطرار إلى الوصول إلى قاعدة البيانات مع كل طلب لأي صفحة. 


إعدادات حالة الجلسة: 


يتم إعداد الجلسة عن عبر الملف عاگمهء.طءس الخاص بالتطبيق (المتواجد ضمن المجلد الافتراضي للتطبيق). 

يمكن هذا الملف من تحديد إعدادات متقدمة لحالة الجلسة. 

يوضح النص التالي أهم الخيارات التي يمكن تحديدها للعنصر <عأه†؟10Sيومي>.‏ 

ملاحظة: لن تستخدم جميع الخيارات دفعة واحدة فهناك خيارات لا يمكن تطبيقها إلا من أجل خيار محدد للخاصة مل0". 


<?xml version="1.0" encoding="utf-8" ?> 

<configuration> 

<system.web> 

<!-- Other settings omitted. --> 

<sessionState 

cookieless="UseCookies" cookieName="ASP.NET_Sessionld" 
regenerateExpiredSessionld="false" 
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:Cookieless sIڏعإلا‎ 


يمكن اسناد أي من القيم المحددة ضمن الترقيم ءل Mءi)هه)م])1‏ إلى هذا الخيار. 

يوضح الجدول التالي قيم هذا الترقيم و وصف كل منها: 

القيمة الوصف 

UseCookies‏ يتم استعمال الكعكات لتخزين محددات حالة الجلسة(حتى في 
حالة عدم دعم المستعرض للكعكات أو إلغاء تفعيلها من قبل 
مستخدم التطبيق). 

هذه القيمة هي القيمة الافتراضية. 

عند اسناد هذه القيمة إلى الإعداد 1018 سيتم تخزين محدد 
الجلسة ضمن ۸1ا ولن يتم استخدام الكعكات حتى في حال 
دعم المستعرض لها. 

UseDeviceProfile‏ عند إسناد هذه القيمة للإعداد ل٥"‏ تقوم ۸8۴.۴۲ باختیار 
استخدام الكعكات أو عدم استخدامها بالاعتماد على معلومات 
llغرض .BrowserCapabi1ities‏ 

نقطة الضعف في هذه الطريقة أنها لا تأخذ بعين الاعتبار اختيار 
مستخدم التطبيق تعطيل استخدام الكعكات على مستعرض يدعم 
استخدامها. 

AutoDetect‏ تقوم ۸5۴.٤1‏ في هذه الحالة بمحاولة تحديد كون 
المستعرض يدعم الكعكات بمحاولة تخزين واستعادة قيمة كعكة. 
تعتبر هذه الطريقة أفضل من سابقتها كونها تأخذ بعين الاعتبار 
تعطيل مستخدم التطبيق لاستخدام الكعكات على المستعرض . 


مثال 


يوضح المثال التالي عمل حالة الجلسة التي لا تستخدم الكعكات. 
يتضمن مثالنا صفحتي وب تستخدمان حالة الجلسة التي لا تعتمد الكعكات. 
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تحتوي الصفحة الأولى ×pءCookieless1.a‏ عنص HyperLink p<‏ وعنصري تكم .Buttons‏ 
تقوم جميع عناصر التحكم السابقة بتوجيه المستعرض إلى الصفحة الثانية ×مءه.s2ءع[ع¡)0هC٤.‏ 
يقوم كل من هذه العناصر بتطبيق عملية إعادة التوجيه تلك بشكل مختلف. 
ë Untitled Page - Windows Intemet Explorer‏ 
x |‏ + 1 ا 5H http://localhost:56371/CookielessSessions/(S(bn3gnc55vu3sq445iltqequq))/Cookieless1 aspx‏ ك )10ء 
i | 6 nite Page [I] BT @ -Broger QToosr‏ 


Link with Relative Path Hyperlink.NavigateUrl is set to 
gg "Ccookieless2.aspx" in code. 


: 2 : The relative path uses 
Redirect with Relative Path | Response.Redirect("Cookieless2.aspx") 


The absolute path uses 


: . Response.Redirect 
[Redirect with Absolute Path | ("http:/ /localhost/.../ Cookieless2.aspx)" 


[@ @ Internet | Protected Mode: On 


يقوم عنصر تحكم kماا[۲ءمر1‏ بإعادة توجيه المستعرض إلى العنوان المحدد ضمن الخاصة 1ال ءاaعNavi.‏ 

يمتثل هذا العنوان المسار النسبي إلى الصفحة ×مكه.s2ءع[عCooki.‏ 

عند الضغط على هذه الوصلةء نلاحظ أن الصفحة الهدف تمكنت من استعادة معلومات الجلسة مما يدل أن حالة الجلسة تعمل بشكل 
طبيعي في الوصلات التشعبية التي تستخدم المسار النسبي. 

يستخدم الزران طريقة إعادة التوجيه البرمجية (0)٥ع1۲لءع۸.ع١١0مءء‏ ۸ للانتقال إلى الصفحة لطضCookieless2.asp.‏ 

يكمن الاختلاف بين الزرين في استخدام الأول لمسار نسبي و الثاني لمسار مطلق. 

نلاحظ أن الزر الذي يستخدم المسار النسبي يعمل بشكل سليم و يحافظ على معلومات الحالة دون أية خطوات إضافية. 


تضيع معلومات الحالة عند استخدام الزر الذي يعتمد المسار المطلق. 


Timeout دIڏeعإلا‎ 


يحدد هذا الخيار عدد الدقائق التي ستمر دون استقبال أي طلب من مستخدم محدد ليقوم ۸5۴.81 بحذف حالة الجلسة. 
تغيير هذا الإعداد قد يؤثر بشكل كبير على الأداء. 

يكمن الخيار الأفضل في هذه المقايضة بإعطاء المستخدم الزمن الكافي للتوقف أثناء التفاعل مع الصفحات» لكن إيقاء هذا الزمن 
أصغرياً لتسريع عملية استعادة الذاكرة القيّمة التي تحجزها معلومات الحالة. 
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يمكن تغيير قيمة هذا الإعداد برمجياً عن طريق الخاصة ٤ا0٠ ٣|.”‏ كما يلي: 


| Session. Timeout= 10 ____ | 
حالة التطبيق‎ 


تمكن حالة التطبيق من تخزين معلومات عامة يمكن الوصول إليها من قبل أي زبون. 
تعتمد حالة التطبيق على الصف System. Web. Http Appاica ti0 ۸S†4e‏ والتي تتوفر ضمن جمیع صفحات الوب عبر غرض 
icationاApp‏ المبیّت . 
تشبه حالة التطبيق حالة الجلسة: 
٠‏ نفس أنماط الأغراض 
ه تقوم بتخزين المعلومات على المخدم 
٠‏ يستخدم نفس الصيغة المفهرسة للعناصر 


مثال العداد العام 


يعتبر مثال العداد العام أحد الأمظة الشائعة لاستخدام حالة التطبيق. 


يقوم هذا المثال بتتبع عدد مرات تنفيذ عملية معينة من قبل جميع الزبائن. 
يمكن استخدام هذا العداد مثلاً لتتبع عدد مرات زيارة صفحة معينة. 


يتم تخزين معلومات حالة التطبيق كأغراض لذلك لابد من عملية تحويلها قسرياً عند استعادتها إلى النمط المطلوب. 
لا يوجد زمن محدد لصلاحية معلومات حالة الجلسة إذ أنها تبقى مخزنة حتي يتم حذفها: 

٠‏ باستخدام الرماز 

٠‏ عند إعادة تشغيل التطبيق 

٠‏ عند تحديث نطاق التطبيق آلياً بفعل تحديث رماز إحدى الصفحات أو مكوناتها 


لا تستخدم حالة التطبيق بشكل كبير بسبب كونها غير فعالة.ففي مثالنا السابق مثلاً سنحصل على قيمة غير دقيقة للعداد عند الوصول 
بكثافة عالية إلى الصفحة. 
يودي الوصول المتزامن إلى الصفحة إلى محاولة تعديل من أكثر من زبون على معلومات العداد في نفس الوقت والذي بنتهي إلى قيمة 
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خاطئة للعداد. 

لمعالجة هذه المشكلة نستخدم الطريقة 10٥))(‏ والطريقة kءهامل.‏ 

يمنع استخدام (0))٥۸.10٥1اهءناممة‏ أي طلب غير الطلب الحالي من التعديل على معلومات الجلسة لحين انتهاء الطلب الحالي 
وتحرير غرض lجlسUn1ockã «Application.‏ 


بدائل استخدام حالة التطبيق 


كما رأينا في المثال السابق »ستضطر جميع الطلبات للصفحة الحاوية على أي تعديلات على معلومات حالة التطبيق» إلى الانتظار لحين 
تحرير حالة التطبيق. 
تؤدي هذه العملية إلى تراجع كبير في الأداء. 
كان الهدف عندما تم اعتماد حالة التطبيق في النسخ السابقة ل ۸8۴ الوصول إلى وظيفتين أساسيتين: 

1- تخزين ثوابت عامة يمكن الوصول إليها من قبل أي صفحة في التطبيق مثل .ConnectionString‏ 

2- تخزين المعلومات المستخدمة بكثرة و التي يتطلب إنشاؤها كلفة عالية (طاقة معالجة و زمن) لإعادة استخدامها عند اللزوم. 
تم تطوير بدائل عن هاتين الوظيفتين باستخدام ملف عاكمهء.ا٠س‏ للوظيفة الأولى والخبء (ع«نطءه))لتغطية الوظيفة الثانية. 


مراجعة لخيارات إدارة الحالة 


يبين الجدولان التاليان جميع خيارات إدارة الحالة و الفروق بينها. 

ViewState Query String Cookies 
سلسة محرفية كمية محدودة من البيانات من | جميع أنماط بيانات 6۲". القابلة | أنماط البيانات المسموح‎ 
نمط سلسة محرفية للسلسلة. تخزینها‎ 

ذاكرة الجهاز الزبون أو ملف السلسلة المحرفية المخصصة | حقل خفي ضمن صفحة الوب مكان التخزين 
نصي صغير بحسب إعدادات ٠‏ لتخزين محدد R1‏ ل ضمن 
زمن حياة الكعكة. المستعرض 

يتم تحديد الزمن من قبل تزول عند إدخال المستخدم | مستمر بالنسبة لعملية إعادة إرسال 
المبرمج تستمر بين الجلسات عنوان 0R]‏ جديد. لصفحة وحيدة. 

ولعدة صفحات. 
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كامل التطبيق. محدود بالصفحة الهدف محدود بالصفحة الحالية 

غير آمنة يمكن تعديلها من واضحة بشكل مباشر غير قابلة للتعديل و لكن يمكن 
قبل المستخدم. للمستخدم يمكن قراءتها و قراءتها بسهولة.يمكن تدعيمخا 
تعديلها بسهولة. باستخدام الخاصة 
ViewStateEncryptionMode‏ 
لا توثر لأن حجم البيانات لا تؤثر لأن حجم البيانات تقوم بإيطاء التطبيق (زمن التأثير على الأداء 
ضر صغیر جداً الإرسال و الاستقبال للصفحة) في 
حال تخزین کم کبیر من 
المعلومات › و لكنها لا تؤثر على 
أداء المخدم. 

موقع الوب. للوصول إلى صفحة 


التقصيلات. 


حالة التطبيق حالة الجلسة 
جمیع أنماط بيانات .N٤1‏ جميع أنماط بيانات E1٤N.من‏ أجل الوضع | أنماط البيانات المسموح 


التخزین ۹۶٤٤٥إم-ہ1۸.‏ تخزينها 
جميع أنماط بيانات .N٤1‏ القابلة للسلسلة 
في وضع التخزين ۲0٤٥88‏ م-0-out‏ 
ذاكرة المخدم ذاكرة المخدم» خدمة الحالة أو مخدم اSQ؟S‏ 
بحسب وضع التخزين المستخدم. 

عمر التطبيق › عادة حت إعادة تشغيل التطبيق. الزمن المحدد ضمن ات٥٣11‏ القيمة 
التلقائية هي عشرون دقيقة. 

كامل التطبيق و بعكس معظم الطرق فهي مرئية | كامل التطبيق و لمستخدم محدد المجال 
آمنة خد لن المعلرمات ل بت اإرساكها الى آم خا نالرات ا بك ار ساكها لى الأمان 
الزبون. الزبون. 
تسبب بطء عند تخزين كمية كبيرة من المعلومات | تسبب بطء عند تخزين كمية كبيرة من التأثير على الأداء 
لأن المعلومات ليس لها عمر محدد و ستستمر المعلومات و بالأخص عند وجود عدد كبير 
بالحياة ما حيا التطبيق. من المستخدمين. 

تخزين أي معلومات عامة. تخزين معلومات سلة التسوق الاستخدام المعتاد 
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الفصل العاشر 
عناصر تحكم التحقق من الصحة 


يتعرف الدارس في هذا الفصل على: 
الغرض من استعمال عناصر تحكم التحقق من الصحة 
أنواع و استخدام عناصر التحقق من الصحة 
التحقق من طرف المخدم و التحقق من طرف الزبون 
صيغة التعبيرات النظامية واستخدامها ضمن عناصر تحكم التحقق 


التحقق من الصحة 
إهمال إدخال قيمة في أحد الحقول ضمن النموذج. 
إدخال بريد الكتروني غير صالح. 
إدخال قيمة غير عددية في حقل مخصص لقيمة عددية. 
قد يقوم مستخدم باستغلال نقطة ضعف ضمن الرماز الخاص بالتطبيق ويقوم بإدخال معلومات مغلوطة بهيكلية محددة بحيث 
تؤدي إلى إعادة معلومات حساسة. 
أحد الأمظة على هذه المقاربة هجوم حقن ا@S؟‏ الذي يزود فيه المستخدم قيماً تقود إلى تشكيل أمر إلى قاعدة البيانات بشكل 


عناصر تحكم التحقق من الإدخال 


توفر ۸8۴.٤1‏ خمس عناصر تحقق من الإدخال أربعة منها مخصصة لنوع معين من التحقق في حين يوفر العنصر الخامس 

إمكانية كتابة إجرائيات تحقق مخصصة. 

توفر ۸8۴.٤1‏ أيضاً عنصر تحكم خاص ۲۷٣١۸80٥اه‏ 1اه بإظهار رسائل الخطاً في الإدخال. 

يوضح الجدول التالي عناصر التحكم تلك مع وصف كل منها: 

صف عنصر التحكم الوصف 
RequiredFieldValidator‏ تنجح عملية التحقق في عنصر التحكم هذا في حال احتواء دخل 

عنصر التحكم على أي سلسلة محرفية. 

|N 7‏ تنجح عملية التحقق في عنصر التحكم هذا في حال احتواء دخل 

عنصر التحكم على قيمة ضمن نطاق رقمي أو حرفي أو زمني 
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41 | تنجح عملية التحقق في عنصر التحكم هذا في حال احتواء دخل 
عنصر التحكم على قيمة موافقة لقيمة في عنصر تحكم آخر أو 
قيمة ثابتة يتم تحديدها. 

RegularExpression Validator‏ تنجح عملية التحقق في عنصر التحكم هذا في حال تطابق دخل 
Custom Validator‏ يتم في عنصر التحكم هذا إجراء عملية التحقق بالاعتماد على 
ملاحظة: يمكن ربط كل عنصر تحقق بعنصر إدخال وحيد كما يمكن ربط أكثر من عنصر تحقق بعنصر إدخال واحد لتوفير إمكائية 
تحقق من عدة أنماط. 

ستنجح عملية التحقق في حال استخدام عناصر تحكم llتحقق gİ CompareValidator « Range Validator‏ 

Regular Expression Validator‏ مع عنصر تحكم إدخال لايحتوي أي قيمة. لذلك يفضل عند استخدام عناصر تحكم التحقق تلك 
إضافة عنصر تحكم تحققJ .RequiredField Validator‏ 


التحقق من جهة المخدم 


يمكن استخدام عناصر تحكم التحقق بشكل ألي للتحقق من صفحة عند إرسالها أو بشكل يدوي ضمن النص البرمجي. 

تعتبر المقاربة الأولى الأكثر شيوعا. 

عند استخدام التحقق بشكل آلي يقوم المستخدم بإدخال المعلومات ضمن عناصر تحكم الإدخال وحال انتهائه يقوم بإرسال المعلومات 

بالنقر على زر لإرسال الصفحة. يمتلك كل زر الخاصة ١٥1اة‏ 1اه ۷ءموںه والتي تأخذ القيمة عد أو مواه؟. 

يعتمد السيناريو الناتج عن نقر المستخدم على زر الإرسال على قيمة الخاصة :CausesValidati0”¬‏ 

- في حال كانت قيمة هذه الخاصة ٥اه‏ تقوم ۸8۴.٤1‏ بإهمال عناصر التحقق من الإدخال المرتبطة بعنصر الإدخالء يتم 

إرسال الصفحة وتنفيذ الرماز الخاص بمقبض حدث الإرسال بشكل طبيعي. 
أما في حال كانت قيمة الخاصة ASP.NET rوقتت true „a CausesValidati0n¬‏ آلا بتقييم الصفحة عند النقر على زر 
الإرسال حيث تقوم بالتحقق من كل عنصر على الصفحة. إذا فشل التحقق من أي عنصر تحكم ستعاد الصفحة مع معلومات 
الخطاً وبحسب الإعدادات الخاصة بإظهار أخطاء الإدخال في كل عنصر تحكم. في هذه الحالة قد لا يتم تشغيل الرماز 
الخاص بمقبض حدث الإرسال» لذلك لابد من التأكد ضمن مقبض الحدث من نجاح عملية التحقق أو فشلها. 

بناءَ على هذا الوصف ندرك أن عملية التقييم تتم بشكل آلي عند ضغط الأزرار وليس عند إعادة إرسال الصفحة من خلال حدث 

ممم أو عند ضغط الأزرار التي تكون فيها قيمة الخاصة ٥1اه‏ موه مساوية ل عواه؟. 

على كل حال يمكننا التحقق من صحة عنصر تحكم يدوياً (باستخدام النص البرمجي) ومن ثم اتخاذ القرار بناءَ على نتيجة التقييم. 


التحقق من جهة الزبون 


تقوم ASP.NET‏ آلا بإضافة رماز ام۲1ء ۷25هل من طرف الزبون لإتمام عملية التحقق في حال تم استخدام المستعرضات الحديثة 


.Internet Explorer yi Firefox Jٽn‎ 
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عند ضغط المستخدم على زر (تم إسناد قيمة عu)‏ إلى الخاصة a1٥١۸‏ ل11 ۷ءعءسهC‏ فيه) سيتم إظهار رسالة التحقق على الصفحة 
دون الحاجة إلى إرسال الصفحة إلى المخدم. تؤدي هذه العملية إلى استجابة صفحة الوب. 

لن يمنع تجاوز التحقق من الصحة بنجاح من جهة الزبون ۸8۴.٤1‏ من إعادة إرسال الصفحة إلى المخدم. تؤمن هذه المقاربة 
حماية من عمليات التجاوز المقصودة للتحقق من الصحة التي قد يقوم بها مستخدم بهدف اختراق التطبيق. 

إن عملية تجاوز التحقق من الصحة من طرف الزبون هي عملية سهلة إذ يمكن للزبون إعادة صياغة أو كتابة أو الاطلاع على منطق 
الرماز أو الحقول المستخدمة لإرسال البيانات في حين تكون هذه العملية صعبة جداً عند استخدام الرماز من جهة المخدم. 

تؤمن عملية الدمج بين التحقق من الصحة من جهة الزبون ومن جهة المخدم مما يوفر أعلى استجابة ممكنة دون التضحية بأمان 
التطبيق. 


عناصر تحكم التحقق 


تعتمد عناصر تحكم التحقق على فضاء الأسماء sإWebControl System.Web. U1.‏ وتقوم بالوراثة من الصف .Base Validator‏ 
يعرف الصف ١0هل‏ 1اه ۷ء84 مجموعة من الخصائص والوظائف نوضحها في الجدول التالي: 


الخاصهة الوصف 
ControlToValidate‏ 


تحدد هذه الخاصة عنصر التحكم الذي سيقوم عنصر التحقق 
بتقييمه. يمكن لكل عنصر تحقق تقييم عنصر إدخال وحيد كما 
يمكن استخدام أكثر من عنصر تحقق لتقييم عنصر إدخال وحيد. 
ErrorMessage and ForeColor‏ تمثل هذه الخاصة الرسالة التي سيتم إظهارها في حال فشل 


عملية التحقق من الصحة. 
تمكن الخاصة ۴٠١١٣٥١10١‏ من إظهار الرسالة بلون مميز. 
تمكن هذه الخاصة من تحديد مكان إظهار رسالة التحقق: 
- يمكن أن يتم إدراجها بشكل ديناميكي ضمن الصفحة 
عند إسناد القيمة 1ص2"( إلى الخاصة رهامء51. 
تفيد هذه الوضعية في حال الرغبة باستخدام أكثر من 
عنصر تحقق لنفس عنصر الإدخال حيث تتراكم 
رسائل الخطاً بشكل ديناميكي. 
في حال إسناد القيمة ء1اه5 إلى الخاصة رهامء¡5 
سيتم حجز حيز خاص للرسالة.تستخدم هذه الطريقة 
عند وجود تصميم ثابت لايرغب المطور بتغييره نتيجة 
الظهور الديناميكي لرسالة الخطأ. 
4 تعيد هذه الخاصة القيمة #ن٠)‏ أو ءاه اعتماداً على نجاح 
التحقق أو فشله. عادة يتم التحقق من الخاصة 14ا1۷ لكامل 
الصفحة عوضاً عن التحقق من هذه القيمة لكل عنصر تخقق 
Enabled‏ يتم تعطيل التحقق من الصحة عند إرسال الصفحة لعنصر 
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التحكم في حال إسناد القيمة f1١‏ إلى هذه الخاصة. 
EnableClientScript‏ عند إسناد القيمة عن]] إلى هذه الخاصة تقوم ASP.NET‏ 
بإضافة نصوص امv48›11ه[‏ و (P11 M1‏ لتمكين التحقق من 
الصحة من جهة الزبون على المستعرضات التي تدعم هذه 
التقنيات. 


الخصائص الفريدة لعناصر تحكم التحقق 


عند استخدام عناصر تحكم التحقق لا بد من إعطاء قيمة للخاصة عa Cont 0211d‏ والخاصة عErrorMess2g‏ كما تتفرد 
عناصر تحكم الحقق بخصائص فريدة تختلف بها عن بقية العناصر نوضحها في الجدول التالي: 

عنصر تحكم التحقق الخصائص الفريدة الإضافية 

RequiredField Validator 

Maximum Value, Minimum Value, Type Range Validator 


ControlToCompare, Operator, Type, CompareValidator 
ValueToCompare 


ValidationExpression RegularExpression Validator 


ClientValidationFunction, Validate EmptyText, Custom Validator 
ServerValidate event 


مثال بسيط على عناصر تحكم التحقق 


يستخدم المثال التالي عنصر تحقق ١0اه‏ ل11ة ۷ ءع١۸4‏ للتحقق من إدخال قيمة ضمن المجال المسموح ضمن عنصر تحكم النص. 
اللقطة التالية توضح شكل واجهة التطبيق: 


a Validation Test - Microsoll Inter nel Explorer 8 


Favtrikes Taos Felp O Sak O ` AA Û) Ase ۳ 7 


number f1 t2 1D: 42 Thus umber ls Mot In The Fanae 
Not validated: 42 


Loca irtrangzt‏ ل 
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يتضمن هذا التطبيق عنصري تحكم علبة نصية إضافة إلى عنصر تحكم التحقق و زر الإرسال. 
فيما يلي النص البرمجي للصفحة: 


<asp:TextBox id="txtValidated" runat="server" /> 

<asp:RangeValidator id="RangeValidator" runat="server" 
ErrorMessage=" This Number Is Not In The Range" 
ControlToValidate="txtValidated" 

Maximum Value="10" Minimum Value=""1" 

Type="Integer" /> 

<br /><br /> 

Not validated: 

<asp:TextBox id="txtNotValidated" runat="server" /><br /><br /> 
<asp:Button id="cmdOK" runat="server" Text="OK" OnClick="cmdOK_Click" /> 
<br /><br /> 

<asp:Label id="lblMessage" runat="server" EnableViewState="False" /> 


أما النص البرمجى الخاص بمقبض حدث ضغط الزر: 
protected void cmdOK_Click(Object sender, EventArgs e)‏ 
{ 


IblMessage.Text = "cmdOK_Click event handler executed."; 


عند اختبار هذا المثال باستخدام مستعرض حديث سنلاحظ أن استجابة الصفحة بإظهار رسالة الخطاً بعد إدخال قيمة خارج النطاق بعد 
ضغط الزر ط14 دون إعادة إرسال للصفحة. 

تم الحصول على هذه الميزة من خلال إضافة ٤1‏ .مء لنص لغة ما٥‏ ؟ة ۷هل من جهة المخدم الذي قام بالاستجابة للحدث الخاص 
بتغيير النركيز من جهة الزبون. 

إن إضافة هذا النص البرمجي من جهة الزبون لا تعد عملية بسيطة و تستهلك بعض الوقت. 

تتم العناية بكل هذه التفاصیل من قبل ۸8۴.۸٤٣‏ بشكل آلي. 

ذكرنا أن النص البرمجي من جهة الزبون غير مدعوم من جميع المستعرضات. 

لاختبار ماذا سيحصل في حال استخدام مستعرض لايدعم ٤م۲1٥725ه[‏ يكفي إسناد القيمة ٥ء[ه؟‏ إلى الخاصة 
.RangeValidator.EnableClientScript‏ 

في هذه الحالة لن تحدث أي عملية اختبار للصحة قبل ضغط زر الإرسال وإرسال الصفحة إلى المخدم حيث تتم إعادة الصفحة مع 
رسالة الخطأ الناتجة عن عملية التحقق على المخدم. 


يرتبط السيناريو السابق بخلل لا بد من تجاوزه و هو أن النص البرمجي الخاص بمقبض الحدث سيتم تنفيذه سواء كانت نتيجة اختبار 
الصحة سلبية أم إيجابية. 


لذلك يجب قسر إيقاف تنفيذ رماز مقبض الحدث في حال عدم تجاوز اختبار تحقق الصحة بنجاح. 
تتم هذه العملية باستخدام النص البرمجي وبالاعتماد على الخاصة 18۷2114 كما يظهر في الرماز التالي: 


protected void cmdOK_Click(Object sender, EventArgs e) 
// Abort the event if the control isn't valid. 


if ((RangeValidator.IsValid) return; 
IblMessage.Text = "cmdOK_Click event handler executed."; 


كما يمكن الاعتماد على قيمة الخاصة 19۷2114 لغرض الصفحة لضمان تجاوز اختبار الصحة لجميع عناصر تحكم التحقق على هذه 
الضنفخة. 


Universal Knowledge Solutions s.a.1. 
126 


خيارات الإظهار الأخرى: 


يمكن في بعض الحالات أن يكون المطور قد قام بإنشاء تصميم لصفحة تتضمن أكثر من حقل. 
قد يؤدي إظهار نتيجة اختبار الصحة بشكل ديناميكي في مثل هذه الحالة إلى إعادة تنسيق غير مرغوب فيها. 
يوفر عنصر التحكم ۸51101021¥ 10هل 1اه ۷ حل مناسب لهذا السيناريو. 
لاختبار عنصر التحكم هذا يجب إسناد القيمة "٠١٥‏ إلى الخاصة رهامء¡ ضمن عنصر تحكم التحقق إ0اه 1اه ۷ءع«Ra‏ (في 
مثالنا). سيضمن هذا عدم ظهور رسالة الخطأ. 
لايعني هذا أن عملية التحقق من الصحة لن تتم وسيتم منع المستخدم من إدخال قيم خاطئة. 
لإظهار نتائج التحقق من الصحة يجب إضافة عنصر التحكم 51121317 ١0اه‏ اه۷ إلى موقع مناسب في الصفحة بحيث لايؤثر 
على التصميم: 
<asp:ValidationSummary id="Errors" runat="server" />‏ 
عند النقر على زر © (في مثالنا) سيتم إظهار لائحة تتضمن جميع رسائل الخطاً التي تم استقبالها من جميع عناصر تحكم 
التحقق. كما هو موضح في الشكل التالي: 
Valldatlon Summary - Microsoft Internet Explorer‏ 3 
File Edit View Favwrrites TIrcols Help O Bark © - E‏ 


Address 3 http: fflacalhast: Z210 apterDEaldatiorSurmmary , aspx 


A number fl to lj: 42 
Mot wraldated: 


+ The Fst Dumber ls Hot lh Tae Eahge 


| Lccalintranet 
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خيارات الإظهار الأخرى (تتمة): 


يمكن استخدام الخاصة ٠٠×٤‏ لعنصر تحكم التحقق لإظهار إشارة تدل على الخطاً في حقل الإدخال حتى في حال استخدام عنصر 
llتحكp .ValidationSummary‏ 
عادة ما يتم استخدام إشارة (*) كما يوضح الرماز التالي: 


ملاحظة: لا بد من الإشارة هنا إلى ضرورة إسناد قيمة مغايرة ل ع٥٣٠"‏ إلى الخاصة رهامء1 لعناصر تحكم التحقق عند 
الرغبة بإظهار إشارات الخطاً المذكور أعلاه. 
يملك عنصر التحكم 121¥ iain‏ خصائص أخرى مفيدة مثل الخاصة ٤×٠٠١ء4ه٥1‏ التي تظهر عنوان خاص أعلى 
لائحة رسائل الخطأ. كما يمكن تغيير لون الإظهار باستخدام الخاصة ۴٠۲١٣٥10۲‏ واختيار نمط الإظهار باستخدام الخاصة 
.DisplayMode‏ 
تحدد الخاصة عله ۷رهامءi‏ إظهار اللائحة على شكل لائحة أو لائحة نقطية أو على شكل مقطع وحيد وذلك بإسناد القيم التالية 
.SingleParaghraph ş BulletList s List‏ 
أخرا يمكن استخدام الخاصة ×80ءعهءوهNسS10w‏ لإظهار رسائل التحقق من الصحة ضمن نافذة منبتقة. 
يستخدم هذا الخيار عند الرغبة بعدم المس نهائياً بالتصميم ضمن الصفحة الحاوية على عناصر التحقق. 
يجبر هذا الخيار المستخدم على النقر على زر 0 ضمن نافذة الرسالة لاستمرار التفاعل مع الصفحةء مما يجعل هذا الخيار غير 
مناسب في حال أراد المستخدم المحافظة على إظهار نتيجة التحقق. 


التحقق من الصحة بشكل يدوي 


أحد الخيارات المتاحة في عملية التحقق هي إجراء العملية بشكل يدوي و لكن باستخدام عناصر تحكم التحقق. 

تمكن هذه الطريقة من الحصول على خيارات أوسع و أخذ قيم أخرى بعين الاعتبار عند إجراء عملية التحقق من الصحة. 

لا بد عند اختيار العمل باستخدام هذه الطريقة من إسناد القيمة عءاه؟ إلى الخاصة ٤م‏ eC|lien†Sc]اEnab‏ لعناصر تحكم التحقق. 
كما لا بد من إسناد القيمة عء[ه؟ إلى الخاصة ۸٥10ا‏ ل11ة۷ءعوuه٤‏ والاستعاضة عنها باستخدام الطريقة ٥)(‏ ۷211 .ع۴۸ لتقییم 
الصفحة بشكل يدوي. 

المثال التالي يوضح هذه المقاربة حيث يتم فحص جميع عناصر التحقق ضمن الصفحة و اختبار قيمة 
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اختبار الصحة اعتماداً على التعابير النظامية 


يعد استخدام التعابير النظامية في اختبار الصحة من أقوى الطرق التي توفرها ۲.۴۲ ۸8. 

تمكن هذه الطريقة من مطابقة سلسلة محرفية ما مع نموذج نمطي معين مثل بريد الكترونيءرقم هاتف» اسم ملف. 

تستخدم التعابير النظامية بشكل كبير في معظم لغات التطوير البرمجية حتى أنها يمكن أن تعتبر لغة بحد ذاتها و تغطي كتاب بكامله إلا 
أننا سنحاول تغطية أساسيات استخدامها. 

تتألف جميع التعابير النظامية من نوعين أساسيين من المحارف و المحارف الوصفية. لا تختلف المحارف عن سلاسل المحارف التي 
نها فى تبرض لفاك البرمجية اذ تر عن ممارف معد مل حرف ۴ مقا و ل شىء غير ها الحرة 

في حين يكمن سر التعبيرات النظامية في المحارف الوصفية حيث يعبر محرف وصفي واحد مثل "*" مثلاً عن جميع المحارف 
الرقمية والأبجدية. 

يوضح الجدول التالي المحارف الوصفية الأساسية و عمل كل منها: 

الوسفا 

عدم ورود أو أكثر من ورود للمحرف أو التعبير الجزئي 
السابق. مثلاً 7*8 تطابق 7778 أو 8 

ورود أو أكثر للمحرف أو التعبير الجزئي السابق» مثلاً: 
8 تطابق 7778 و لا تطابق 8 

تجمع تعبير جزئي ليتم معاملته كعنصر وحيد ضمن التعبير 
النظامي»ء مقلاً: 

+(78) تطابق 78 و تطابق 787878 

تحدد ورود المحرف أو التعبير الجزئي السابق من "ص إلى ۸" 
مرة» مقلاً: 

۸1,3 تطابق ۸ و ۸۸ و ۸۸۸ 

تطابق مع أي من طرفيها مثلاً: 

6 تطابق 8 أو 6 

تطابق مخرف أن أكر من محال المحارف المح .مقلا: 
]۸-٤C[‏ تطابق ۸ أو 8 أو ٥‏ 

نطق مخرف ليشن ضنمن المجال المجددء مقلا: 
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.Space 


بعض التعابير النظامية الشائعة 


يبين الجدول التالي مجموعة من التعابير النظامية الشائعة الاستخدام: 


المحتوى 


عنوان بريد الكتروني 


كلم شر 


حقل بطول محدد 


الرقم التأميني (بحسب التنسيق المستخدم 
في الولايات المتحدة) 


التعبير النظامي 
\SH@\SANS+‏ 


\w 


\w {4,10} 


[a-zA-Z]\w {3,9} 


[a-zA-Zj\w*\dH\w* 


1844,10} 


\d{3}-\d{2}-\d {4} 


مجموعات التحقق 


B وA تطابق أي محرف عدا‎ [^A-B| 
there ş where ةanٹlکJl‎ .h1ere تطابق‎ 


أي كلمة محرفية (حرف» رقم »شرطة سفلية). 


الوصف 
يتم التأكد من وجود إشارة @ و إشارة 
النقطة دون السماح بوجود فراغات 
أي تسلسل كلمات محرفية 
(أحرفءفراغات و شرطة سفلية) 
طول كلمة السر بين 4 إلى 10 محارف 
تم تحديد طول لكلمة السر بين 4و 10 
محارف على أن يكون المحرف الأول 
حرف عادي من z-ھ‏ أو من ۸-7 
في هذه الكلمة هناك شرط للبدء بمحرف 


متبوعا بكلمات حرفية ثم رقم أو أكثر ثم 
يسمح بإدخال 4 إلى 10 محارف و لكن 
فع بالممارت خاس 


تسلسل من ثلاث أرقام ثم رقمين ثم أربعة 


أرقام مفصولة بشرطة. 


قد تحتوي الصفحات المعقدة على أكثر من مجموعة منفصلة من عناصر التحكم الموزعة أحياناً على أكثر من عنصر تحكم 1عصه۴. 
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في مثل هذا السيناريو قد يرغب المطور في إجراء عملية تحقق من الصحة لكل مجموعة بشكل منفصل. 
مثلاً يمكن أن نقوم بإنشاء نموذج يتضمن عناصر تحكم تسجيل الدخول كما يتضمن في حيز منفصل عناصر التحكم الخاصة بتسجيل 
مستخدم جدید. 
يحتوي كل جزء من جزئي النموذج المذكورين زر إرسال خاص.يتم إجراء التحقق من الصحة بناء على نقر أي من زري الإرسال. 
لكن عملية التحقق يجب أن تتم فقط لتلك العناصر الخاصة بذلك الجزء من النموذج. 
يمكن تحقيق هذا السيناريو باستخدام مجموعات التحقق. 
لإنشاء مجموعات التحقق يكفي وضع عناصر تحكم الإدخال»عناصر التحكم و زر الإرسال (الذي تم تفعيل خاصة 
idationاausesVa‏ فيه) ضمن نفس المجمو عة المنطقية. 
يتم الوصول إلى هذا الغرض بإسناد اسم المجموعة المنطقية و لیکن مثلاً lin Group‏ إلى الخاصة 0up‏ ا6 Validation‏ لجمیع 
عناصر التحكم التابعة لهذه المجموعة المنطقية بما يتضمن زر الإرسال. 
يوضح المثال التالي هذه الفكرة: 


عند نقر زر 1م١٥6۲‏ 48ل 1اه سيتم التحقق من صحة العلبة النصية الأولى فقط وكذلك الأمر بالنسبة للعلبة النصية ضمن اللوحة 
.Panel2Panel2‏ 

ملاحظة: في حال استخدام عنصر تحكم ضمن هذا السيناريو دون تحديد المجموعة المنطقية التي ينتمي إليها سيتم التحقق من صحته 
عند التحقق من صحة أي مجموعة منطقية أخرى. 
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3 Lnlitled Page - Microsoft Internet Explorar 
Fil Edt wew Fails Tons Hep Okt: O ` A 


http localhost l1SESYald atan alidatiortaro_ps asp‏ ك 


Walida1ia Grup 


| Walidat3 Grmoupê 1 


Inktane:‏ اد ل 
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الفصل الحادي عشر 
إدارة البيانات في ١×٤1‏ 


إدارة البيانات في ۸8۲۴.۸٤۲‏ 


سنغطي في هذه الجلسة المواضيع المتعلقة بإدارة البيانات في N۴١‏ .۸8۴. ونقصد هنا بتعبير إدارة البيانات عمليات الوصول إلى 
البيانات المخزنة في ملفات وتطبيقات أخرى ومعالجتها. 


نسمي في الإطار العام» مصادر المعلومات بمخازن البيانات. 


يتضمن إطار عمل .N8E١‏ مجموعة من الصفوف التي تتبنى تقنيات وصول متقدمة إلى البيانات المصممة خصيصاً للاستخدام مع 
.(.NET)‏ 


مخازن البيانات والوصول إليها 


يرتبط مفهوم إدارة البيانات بمصادر البيانات العلائقية مثل قواعد البيانات» ولكن تقنيات إدارة البيانات في .E1‏ تقدم إمكانيات أخرى 
متميزة منها: الاتصال والتعامل مع ملفات 11× والتقنيات المرتبطة بها. 


تاريخيأًء كانت قواعد البيانات عادة مبنية على ملف وتستخدم طول سجل محدد كما هي الحال في ملفات ا×ا. 


إذ كانت تجري قراءة الملفات إلى جداول من قبل برامج قواعد البيانات أو تقنيات الوصول إلى البيانات» وكانت تطبق قواعد موجودة 
في ملفات أخرى لربط سجلات من جداول مختلفة بعضها ببعض. بعد نضو ج هذه التقنيات ظهرت قواعد البيانات العلائقية لتوفر طرق 
تخزين أفضل مع الطول الديناميكي للسجل و تقنيات وصول أكثر فعالية للبيانات. على أي حال بقي مكان التخزين الأساسي هو قاعدة 
البيانات. 


الانتقال إلى البيئة الموزعة 
في السنوات الأخيرةء تغيرت العديد من المتطلبات وآليات عمل التطبيقات في معظم الأعمال وتم الابتعاد عن مفهوم قاعدة البيانات 


العلائقية المركزيةء وأصبحت البيانات موزعة بين مخدمات البريد الالكتروني ووثائق المكتب وأماكن ووسائط أخرى» ضمن قواعد 
البيانات أيضاً. 
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إدارة البيانات في آ٤×.‏ 


توجد تقنيات جديدة للوصول إلى البيانات» تتناسب مع البيئة الجديدة الموزعة التي تكلمنا عنها. لذا سنستعرض ما تقدمه .×٤۲‏ فعليا 
في هذا المجال. 


سنبدأً بإعطاء لمحة عامة عن جميع صفوف إدارة البيانات في ٤1‏ .. لنرى كيف تنسجم جميع أغراض إدارة البيانات مع بيئة البرمجة 
المهيكلة التي تقدمها .).×.٤1(‏ 


فضاء الأسماء: 
تبنی جمیع صفوف إدارة البيانات العلائقية على فضاء الأسماء 4أ2ل.10ءاءرء ويطلق عادة أ6م.0 له على فضاءات الأسماء الموجودة 
في الجدول التالي: 


فضاء الأسماء الوصف 

4 | يتضمن جميع الأغراض الأساسية المستخدمة للوصول إلى» وتخزين البيانات 
في قواعد البيانات العلائقية. من هذه الأغراض: †eءه†ة‏ و eااة0ata1‏ و 
.DataRelation‏ تكون كل من هذه الأغراض مستقلة عن نمط مصدر 
البيانات والطريقة التي نتصل بها بهذا المصدر. 
System.data.common‏ تحتوي الصفوف الأساسية المستخدمة من الأغراض الأخرى وخاصة 
الأغراض العامة من فضاء الأسماء 5ء01 و أدعنا٥S41.‏ بصورة عامة لا 
نقوم باستيراد فضاء الأسماء هذا في تطبيقاتتا. 
System.data.OleDb‏ يحتوي الأغراض التي ق للاتصال مع مصدر البيانات باستخدام مزود 
.0€Db0ommand » OleDbConnection Jتم Ole-Db‏ ترث ھذە 
الأغراض طرق وخصائص من الصفوف المشتركة 
System.data.SqIClient‏ تحتوي الأغراض التي يمكننا استخدامها للاتصال مع مصادر البيانات عبر 
سياق من البيانات الجدولية الخاصة ب 5Q1 S۲۷٥۲‏ فقط. حيث توفر أداء 
أفضل بإزالتها بعض الطبقات الوسيطة المطلوبة من اتصال 58 _٤ا0.‏ 
ترث الأغر اض مثل 101اSQLConnec‏ و SQL C0mmand‏ من الصفوف 
المشتركة ك ط015 الخصائص و الطرق و الأحدات. 
تحتوي الصفوف اللازمة لاستخدام أنماط البيانات في قواعد البيانات العلائقية 
مثل إ۷eإمSاSQ‏ و المختلفة عن تلك القياسية في .N.٤٣‏ كأغراض 
.SqlBinary s SqlMoney. SqlDateTime  System.Data.SqIType‏ 
يحسن استخدام هذه الأغراض الأداء بشكل ملحوظ ويقلل أخطاء التحويل بين 
أنماط البيانات. 


هناك أيضاً سلسلة من فضاءات الأسماء الحاوية على صفوف يمكن استخدامها للتعامل مع ملفات 1× بدلا من استخدام قواعد 
البيانات العلائقيةء تكون هذه الأسماء مبنية على 1ص×.11ءكر؟. 
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الوصف 
تحتوي الأغراض الأساسية اللازمة لإنشاء» وقراءة > وتخزين» وكتابة ومعالجة ثائق 
XM‏ بحسب توصیات ¥3°. 

تحتوي ٤1ع‏ دصںء0 12× بالإضافة إلى سلسلة من الأغراض التي تمتل أنواع مختلفة 
من العقد في وثيقة -اM×.‏ 

تحتوي الأغراض المسؤولة عن إنشاء» وتخزين» ومعالجةء الهيكل والعقد المحتواة في 
هيكل وثيقة .××M1-‏ 

يحتوي مجموعة من الأغراض التي يمكن استخدامها لتحويل وثيقة ۷1× إلى تنسيقات 
أخرى مختلفة مثل 90۸۴ للنقل عبر الشبكة مقلاً. 

يحتوي الصفوف اللازمة لتطبيق عمليات القراءة» والتخزين والكتابة واستعلام عن 
System.Xm1.Xpath‏ | وثائق ۷1× باستخدام غرض مبني على ه۴×. تتضمن أغراض مثل 
XpathDocument‏ و Xpath Navigator‏ والأغراض التي تمثل تعبیر ات ۴٤1‏ ×. 
يحتوي الأغراض اللازمة لعملية تحويل ملف ۷1× إلى تنسيقات أخرى باستخدام 
XS‏ و 1اXS.‏ يكون الغرض الأساسي فيه ھو 1إXs1T1ransf0‏ 


System.Xml 


System.Xml. Schema 


System.Xml.Sirialization 


System.Xml.Xs1 


استيراد فضاءات الأسماء اللازمة للعمل مع مصادر البيانات 


لا بد للصفحات التي تستخدم أغراضاً من مكتبة صفوف إطار العمل .NE1‏ أن تستورد فضاءات الأسماء الحاوية على 
الأغراض التي تريد إنشاء مثيل عنها. يجري استيراد الكثير من هذه الفضاءات تلقائيا 

لكن فضاء أسماء إدارة البيانات ليس من تلك الفضاءات التي يتم استيرادها تلقائيأًء لذا يجب علينا استيراده بصورة صريحة في 
التض البرمجي 


للوصول إلى قواعد البيانات العلائقية لا بد لنا من استخدام فضاء الأسماء 8518۳.024 على الأقل و أي من 
System.Data.SqlClient jİ System.Data.OleDb‏ اعتماداً على الطريقة التي نود الاتصال بها مع مصدر البيانات و ذلك 
بالصيغة: 


<$@GImport Namespace="System. Data" 
Import Namespace="System. Data. OleDb" 


<$S@Import Namespace="System. Data" 
Import Namespace="System.Data.SqlClient" 


يمکن في ۷/8.٤۲‏ استخدام sاامم‏ "| و في C#‏ استخدام وہ Us‏ 


هناك حالات خاصة نضطر فيها لاستيراد فضاءات أسماء أخرى كحالة إنشاء عنصر من الغرض وام مaةe×Nءاطa‏ ۲ ه0at»‏ حيث 
يتو جب علينا استير اد فضاء الأ٘سماء .System.Data. CON N07‏ كما یتوجب علینا استیراد System.Data .S4ا| y٥‏ عندما 
نريد استخدام أنماط بيانات من الأنواع التي يستخدمه S٩|S6 ۲۷٥۲‏ 
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للوصول إلى بيانات 11× باستخدام الأغراض في صفوف مكتبات ٤6ء‏ يمكننا غالبا غض النظر عن استيراد فضاء الأسماء 
الأساسي System.Xml|‏ . 

على کل حال سنضطر إلى استير اد فضاء الأسماء 2۸م×.|System.×m‏ عندما نرید إنشاء غرض .Xpath Document‏ 
وسنضطر أیضاً لاستیراد فضاء الأسماء ا۳.×۳۸۱.×5 8/518 عند استخدام الغرض ۸50۲۳ 5۲× عند إجراء عمليات تحويل 
من جهة المخدم على وثائق ا٧ا×.‏ 

كما يلزمنا استير اد فضاء أسماء ۳2ع۸عءS.اص×.mهاSys‏ عند العمل مع ال كج۴۳٥۸ءŠ‏ (المخططات والهياكل). 

أُما بالنسبة لأغر اض متل 6۲ Xm Validating Read‏ فلا نحتاج فيھا إلى اwتıر‏ اد .System.Xml.Schema‏ 


في حال نسينا استيراد أي من فضاءات الأسماء اللازمة سنحصل على رسالة خطاً من الشكل: 
Server Error in '/7035' Application.‏ 


Compilation Error 


Descriplioni An emor occured during tie compilation of 3 reource reqined to sêrite His request 
Fieate fee the feAoming LPECISE Eftor Geta 30d ROOFYy yolu sorte cotê apptGEralek' 


compiler Error Message: BCAOOID TYE SHC ONMECEHOT HS FOL GofINEG 

Soiifrêê EfFOF? 

LIne 43: 2 2 
Line 4d: ‘Eraate 3 hew Conneetisn object sing the. connection string 
LiRnê 45: Din objConnect As New SqKomnecttonlstrConnecTt) 


LIRE A6: 
Linê A7: "apên the connection t0 the database 


source Fle CNnatpubimamaGoRTOSTTa aC cessdala0 ilareader-aql ap Limei 4 


Show Patallid Goimpilar Output 
Show Gomplakte Compilation Source; 


Version Information: Microsoft KET Frapeauk Yersian 1 0 3517 [ ASF NET versed 036170 


أغر اض ۸D0.N ٤۲‏ الأُساسیة (1) 
اعتمدت طريقة الوصول التقليدية إلى البيانات -والتي استخدمت تفنية ۸[0- على غرض رئيسي وحيد هو اءءلإهء ۸ء وكانت 
٠‏ تأسيس اتصال بقاعدة البيانات باستخدام مjزود OLE-DB رڊe ODBC ڪyİ 0LE-DB‏ 
تنفيذ أوامر على الاتصال المنشأً 


تخزین البیانات ضمن غرض ٥‏ 0۲۵8٥ء۸‏ لاستعادتها 
يمكن لهذا السيناريو أن يتم باستخدام الغرض ٥٥1۳۵۸4‏ أو عن طريق غرض ٥٥١٣٥٥٤0١‏ مباشرة 
لإدراج أو تعديل البيانات يمكن ببساطة تنفيذ عبارة 501 أو إجرائية مخزنة باستخدام الغرض C٥۸٣8 ٤10١‏ والغرض 


R‌ec0۲dءع1 دون استخدام الغرض‎ Command 


يكمن الفرق الرئيسي في أن الغرض ١٥ل2٠‏ ۸ه( يساعد في الوصول إلى البيانات باتجاه واحد و للقراءة فقط. 
في حين يوفر الغرض اه4( آلية للتعامل مع أكثر من مجموعة من الصفوف من نفس مصدر البيانات» حيث يمكننا إنشاء غرض 
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8€ من بيانات موجودة ضمن مصدر البيانات» أو من ملئها بصورة مباشرة صف تلو الآخر باستخدام النص البرمجي. 


يحتوي كل جدول ضمن الغرض 0486 على معلومات حول القيم الأصلية للبيانات أثناء عملنا عليهاء بحيث يمكن إرسال أي 
تعديلات على البيانات إلى مخزن البيانات في وقت لاحق. 

يحتوي الغرض 04156 معلومات تصف محتوى الجداول» كأنماط الأعمدةء القواعدء والمفاتيح. 

يجب أن نتذكر دائماً أن التركيز في الغرض 4861ة هو القدرة على العمل بصورة دقيقة و فعالة في بيئة غير متصلة 

يحافظ الغرض (a1486‏ على محتوياته ويستطيع تحميل معلومات من وثيقة ۷1× الحاوية على بيانات مهيكلة بالتتسيق الصحيح. 


يعتمد الوصول إلى البيانات في .N81‏ على نفس الخطوط العريضة ولكن باستخدام مجموعة أخرى من الأغراض. قد تبدو هذه 
الأغراض مشابهة لكنها مختلفة بشكل جذري داخلياً مع اختلاف في الأداء ومرونة أكبر. إذ تعتمد أغراض الوصول إلى البيانات 
في ۴1'. على غرضین أساسيين الأول ata Reader‏ والثاني هو .45٥‏ ينفذ كلا الغرضين العمل الذي كان الغرض 
أ€ Recor‏ يقوم به. 


أغراض ۸00.۸٤١‏ الأساسية (2) 


أهم أغراض ۸20.٤1‏ الأساسية هي: 
غر اض Connection‏ 
أغراض الأوامر 
غر اض Data Adapter‏ 
الغرض 54)8٥‏ 
الغرض Data ۷1ew‏ 
llغرض Data Reader‏ 


Connection ضlرغİl‎ - 


يشبه هذا الغرض بصورة كبيرة الغرض المستخدم مع ۸(0 ويحوي خصائص مشابهة له. يستخدم هذا الغرض لوصل غرض 
mand‏ €0 بمخزن البیانات . 


تخد llغرض‏ ¬ڼOleDbConnecti0 OLE_D8 دوjn ga‏ 
۵ يستخدم الغرض S41٣٥٣٣٤ ٤1٥١‏ ما يسمى 1(8 مع نظام إدارة قواعد البيانات ۲ءSQ18¢۲۷‏ 
٠‏ كان من الممكن سابقاً لغرض ١٥1ا‏ #«هه) تنفيذ تعليمات 8Q1‏ على مصدر البيانات أو فتح غرض ٠٥0۲86‏ ۸. أما في 
8P. N۴1‏ فهذا غير ممكن. على كل الأحوالء تؤمن أغراض الاتصال السابقة الوصول إلى المناقلات التي تكون قيد التنفيذ 
علی مخزن بیانات معین 
من أهم الأغراض المستعملة لكل من غرضي |ێتصJi :SqlConnection s OleDbConnect‏ 


الطريقة الوصف 
Open‏ تقوم بفتح اتصال إلى مصدر البيانات باستخدام الإعدادات الحالية مثل 
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nnectionStringد‏ التي تحدد معلومات الاتصال المطلوب استخدامه. 
Close‏ تقوم بإغلاق الاتصال الحالي مع مصدر البيانات. 

BeginTransaction‏ تقوم بدا مناقلة مع مصدر البیانات و تعید غرض 1۲٣٤2٥٤1٥0۸‏ الذي يمكن 

استخدامه لإتمام أو إلغاء المناقلة. 


' SQL Server Provider Sample 

DI CONMSEE AS SELIM = HOAla SOUECS= (LOCAL & _ 
Ini lLial CalalGT NOTE USEE Id Sa 

Dim Cnn AS New SglIConnéection (GONNSTEE) 

cnn. Open () 

' Use the connection in here... 

If cnn.State = ConnectionState. Open Then 
CM. CLOSES () 


ma 


ب - أغراض الأوامر 


تشبه هذه الأغراض مثيلاتها ٥٥1٣۳2٣4‏ في ۸(0 وتمتلك نفس الخصائص»› وا لوصل غرض ٤٥0۸1010۸‏ مع 


غرض DataReader‏ و غرض DataAdapter‏ 
يستخدم الغرض 1٦214‏ 0٣0ء01‏ مع مزود OLE-D8‏ 
٠‏ يستخدم الغرض $41٥0”‏ مع خدمات البيانات الجدولية في SQ 1S۷‏ 
يسمح الغرض C٥1 ۳2١4‏ بتنفيذ عبارات 501 أو إجرائيات مخزنة على مصدر البيانات. يتضمن هذا إعادة مجموعة صفوف 
(حيث نستخدم للوصول إليها غرض آخر كالغرض ١ءلهء‏ 4۸اه( أو كالغرض ١ءام4ل4ه41()‏ أو إعادة قيمة وحيدة» أو إعادة عدد 
العناصر المتأثرة بالاستعلامات التي لا تعيد مجموعة صفوف 


الطريقة الوصف 

تقوم بتنفيذ الأوامر المعرفة في الخاصة C٥۳2١ ۲١×٤‏ باستخدام الاتصال 
المعرف بالخاصة ١0نا‏ ممه والمرتبطة باستعلام لا يعيد أي صفوف (كتعليمة 
ExecuteNonQuery‏ 
Update‏ و Delete‏ أو اع1n).‏ تجري إعادة رقم صحيح يعبر عن عدد الصفوف 
التي تأثرت بهذا الاستعلام. 

تقوم بتنفيذ الأمر المعرف في الخاصة C01١١ 14 1×٤‏ باستخدام الاتصال 
ExecuteReader‏ المعرف في الخاصة .)٥1 1١٥٥٤10١‏ تعيد هذه الطريقة غرض ]٥21٥۲‏ متصل مع 
مجموعة الصفوف في قاعدة المعطيات بشكل يسمح بالحصول على الصفوف. 

تقوم بتتفيذ الأمر المعرف في الخاصة C0101 14 1٥×‏ باستخدام الاتصال المحدد 
في الخاصة .]0118٥٤10١‏ يعيد قيمة وحيدة هي العمود الأول من السطر الأول 
من مجموعة الصفوف التي يعيدها الاستعلام» ويتم إهمال جميع القيم الأخرى 
المعادة. هذه الطريقة سريعة و فعالة عندما يكون المطلوب إعادة قيمة وحيدة فقط. 


ExecuteScalar 
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' OLE DB Provider Sample 
DAM SESSON ZS SEEING SS LL SUECD E BROOM SUS EOE 
Dim cmd As New OleDbCommand (strSQL ,cnn) 


' SQL Server Provider Sample 
DM SEES OU AS SENS LC OEUHOND E BHEROM EUS EOMEE SA 
Dim Cema AS Mew SGLCOMMaAnRdA (SESSION CRR) 


DataAdapter ض|رغİi‎ ¬ ج‎ 


يعتبر هذا النوع من الأغراض نوعاً خدكا يقوم بوصل غرض ٣2٣4‏ ده أو أكثر بغرض ٥8؟ه†ه5.‏ 
٠‏ الغرض ١ء (a4۸ dap‏ ط010 المستخدم مع مزود OLE-D8‏ 
٠ه‏ الغرض ١ءم2‏ 541244 المستخدم مع خدمات البيانات الجدولية الخاصة ب M8 S؟SQ1 Seve‏ 


توقر هذه الأغراضن أربعة خصاتض ترف الأرامر المستخدمة للتعامل مع البيانات قي مخزن البيانات: 


DeleteCommand , UpdateCommand ڪ‎ InsertCommand sy SelectCommand 
٤°٥٣ ا10١ (يمكن لكل هذه الأغراض الاشتر اك بغرض‎ ٥٥ه‎ ٣٠214 حيث تشكل كل من هذه الخصائص مؤشر إلى غرض‎ 


وحید). 


تقدم كل من أغر اض ۲ع †م 01eDb 24A d2‏ و Sg] Dat Adapter‏ مجموعة من الطرق للعمل مع أغراض 56( التي تطبق 
عليها. أهم تلك الطرق ثلاثة هي: 


الطريقة الوصف 

۴1 تقوم بتتفيذ الأمر لةه 1ءء1م؟ لتأهيل الغرض 01861 بالبيانات من مصدر 
البيانات. كما يمكن أيضاً استخدامها لتحديث المعلومات المتوفرة ضمن جدول في 
غرض 041486 بالتعديلات التي تمت على البيانات في مصدر البيانات الأصلي إذا 
كان هناك مفتاح رئيسي يميز صفوف البيانات في الجدول ضمن غرض اأءءه)a.‏ 
FillSchema‏ تستخدم الأمر ١2١d‏ "00١1ء‏ لاستخلاص البنية الهيكلية لجدول من مصدر 
بيانات و تقوم بإنشاء جدول فارغ في غرض (25٥1‏ مع جميع القيود التي تحددها 
تتم ڊiulدsle‏ الأوlمر «UpdateCommand «InsertCommand‏ 
»Deete€Command‏ لكل صف تم تعديله أو حذفه من الغرض (48٥‏ بحيث 
يجري تحديث هذه البيانات ضمن مصدر البيانات الأساسي» باستخدام التعديلات التي 
تمت على محتوى الغرض ٥5ه)04.‏ 
تشبه هذه الطريقةء الطريقة 821ء2 لمل المستخدمة مع غرض ءء0۲٥۸‏ في 
۸0 و لكن في حالة ۸20 لا يتم التعديل على أكثر من جدول. 


Universal Knowledge Solutions s.a.1. 
139 


CoNnNSTET AS GCIEING =. FPTOTIQdGT VEFOLEDE TF Daa Source 
Cr SAMPLES DATA TESTUATA. DECOY 


SEESOL AS Sili = SSUNCOT * ROM EEOCUEESY 


oda As New OleDbDataAdapter (strSQL, connStr) 


CEMOIMSELE 4S NEw OlEDICOMIAG (SINS INO PEOCUEES C&C | 
"(DPEOCUEE AEC, SEO Mame) VALUES (10,eac)%) 


.InsertCommand = cmdInsert 


د - الغرض 54)45 
يقدم الغرض 445٥‏ أساسيات التعامل مع قواعد البيانات العلائقية ووسائل تخزين البيانات في بيئة غير متصلة. 


تتلخص الفروق الأساسية بين الغرض 414861( و الغرض ء0۲۵8٠٠۸‏ ( في 450) بما يلي: 
٠‏ يمكن لغرض (415٥‏ أن يتعامل مع أكثر من مجموعة صفوف ويحتوي معلومات تخص العلاقة بينهاء في حين لا 
يقدم الغرض ٥0۲45ء۸‏ سوى إمكانية التعامل مع مجموعة صفوف واحدة 
يوفر الغرض 0415٥1‏ وصول غير متصل إلى البيانات بصورة آلية 
يكون كل جدول في الغرض (445٥1‏ عبارة عن غرض من النو ع 1ا2 41( ينتمي إلى المجموعة كعاطه1. 


يحتوي كل غرض 1ط04414 على مجموعة من أغراض 01۸0۷ و مجموعة من أُغراض ۸ صuاہ‌٥DataC‏ 
هناك أيضاً مجموعات خاصة بالقيود كقيد المفتاح الأساسي و القيم التلقائية و العلاقات بين الجداول 


أخير ا لدينا الغرض wWء1‏ 1۷٠٤ء(‏ الخاص بكل جدول و المخصص لإنشاء غرض (4۷1١۷‏ على ذلك الجدولء وذلك لتقدیم 
إمكانيات البحث في البيانات و التعامل معها أو ربطها بعنصر تحكم. 


نقوم بتأهيل هذا الغرض من مخزن بيانات» ثم نقوم بالتعامل معه في حالة غير متصلة مع هذا المخزن» ثم نقوم بالاتصال وإتمام 
التغييرات على مخزن البيانات حسب الحاجة. 


يكون كل جدول في الغرض (445٥‏ عبارة عن غرض من النوع 1اة 41( ينتمي إلى المجموعة كء1طه1. 


يقدم الغرض 041861 مجموعة من الطرق التي يمكن استخدامها للتعامل مع محتويات الجداول أو للتعامل مع العلاقات القائمة فيما 
بينهاء مثل عمليات مسح محتوى غرض 561( أو عملية دمج محتويات أكثر من غرض ع448 2: 
الطريقة الوصف 

۳ | تقوم بإزالة جميع البيانات المخزنة في الغرض 04148٥1‏ و ذلك بتفريغ جميع الجدوال التي 
تحتويها. تكون عملية تدمير الغرض و إعادة إنشائه أكثر فعاليةء في بعض الأحيان) إلا في حال 
الرغبة بالمحافظة على مؤشر لهذا العنصر. 
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تقوم هذه الطريقة بدمج محتوى غرض 0486 مع محتوى غرض 041486 آخر منتجة 


غرض (35٥‏ يحتوي جميع البيانات من كلا الغرضين. 


ذكرنا سابقاً التنسيق التلقائي الذي تعتمده .N٤1‏ هو تنسيق 1× عند تخزين البيانات. لذلك يقدم الغرض 04186 مجموعة من 
الطرق لقراءة و كتابة بيانات من وإلى وثائق ا١×.‏ 

الطربقة الضف 
ReadXml‏ تقوم بقراءة معلومات وثيقة 1× أو هيكل ۷1× و تأهيل غرض 5448٥‏ 
و بها 
ReadXmlSchema‏ 
GetXml‏ تعيد سلسة محرفية تحتوي وثيقة ۷1× أو هيكل ۷1× الذي يمتل البيانات في 


و 
GetXmlSchema‏ 


Watexml‏ تقوم بكتابة وثيقة ۷1× أو هيكل ۷1× الذي يمثل البيانات ضمن غرض 


2 ataSetط‏ إلى ملف القرص gy‏ غرض Reader/Writer‏ 
WriteXmlSchem‏ ای و 


غرض ع02)48. 


تقوم أغراض (a56‏ مع أغراض ه4121( التي تحتويها بالاحتفاظ بسجل عن قيم محتوياتها عند إنشاءها أو تحميلها إذ يعتبر 
هذا الأمر مطلب أساسي مهم للسماح بتتبيت التغيرات في مخزن البيانات الرئيسي وبالأخص في بيئة متعددة المستخدمين. 


متال 


CORRNSEE AS SEEING = PrOVIMEE=VTPOLEDS. 17 DIA SOUEEES™ & | 
SCS  EANPTLESIDATA TEC TDATE LET 


Din SLESOL AS Slr ine = VOSLHCT * ROM PrOCUEE SE 
Dim oda As New OleDbDataAdapter (strSQL, connStr) 
Dim ds As New DataSet () 

Dim dr As DataRow 


GEA. ELL NOS, EEOCUEE LEO 


Or Maem Ci In CE. TELES (Y ErOQMUE LIN EONY ROMS 
JS DEMO LEEMS . ACC (AE (PEON NEme ) .TOSEEIRG) 
Next dr 


Mamê EO ONS A MEARIOMNS EOEM GOES ULES EMS CASS 
dgdDemo.DataSource = ds.Tables ("ProductInfo™) 


يقدم الغرض 44561( أربعة طرائق لإعطاء قدرة أكبر على التحكم في كيفية ولحظة تثبيت البيانات: 

الطريقة الوصف 
AcceptChanges‏ تقوم بإتمام وتثبيت جميع التغييرات الحاصلة على الجداول والعلاقات ضمن غرض 
8 منذ أن تم تحميلها أو منذ آخر مرة تم تنفيذ الطريقة sعءع ٤٣12‏ م ۸٥»‏ فيها. 
GetChanges‏ تعيد هذه الطريقة غرض (a1561‏ يحتوي بعض أو كل التغيرات التي تمت منذ تم 
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تحميل الغرض أو منذ آخر مرة تم فيها تنفيذ الطريقة عع ٤121‏ ۲معِAcc.‏ 
HasChanges‏ تحدد فيما إذا تمت أي تعديلات على البيانات منذ تحميل الغرض أو منذ آخر مرة تم 
تنفيذ الطريقة sءع 12٣‏ ٣1مءءء۸‏ فيها. 

RejectChanges‏ تقوم بإهمال جميع التعديلات التي تمت على القيم في الجداول ضمن غرض ء5448 
منذ تحميل الغرض أو منذ آخر مرة تم تنفيذ الطريقة sعع٣ة‏ !٣م٥٥٥۸‏ فيها. تعيد هذه 
لطريقة المعلومات إلى الوضع الأصلي و تزيل جميع المعلومات المخزنة عن 
التغييرات. 


الغرض ء141 :Da)4‏ 


كل غرض 1ط٣41ه(‏ يمتلك خاصة تسمى سه۸ تؤشر إلى غرض ١10ا›ء11٥ 0W ٣‏ 4)۸( وهو عبارة عن مجموعة أغراض 
.DataRow‏ 


يوفر الغرض 1ا14( مجموعة من الخصائص و الطرق التي تسمح بالتعامل مع كل جدول من جداول غرض a45٥1‏ على 
خدئ: من أكث ر الطرق اسشخداما هي الطرق 2ء1٣‏ و AcceptChanges‏ و Regect Changes‏ و هي مطابقة لتلك التي يدعمها 
الغرض 456( إلا أنها تطبق فقط على جدول وحيد هو الجدول الذي يؤشر إليه الغرض ء1طاه1هه5. كما أن هناك مجموعة من 
الطرق الأخرى التي تسمح بالتعامل مع محتويات الجدول وهي: 
الطريقة | الوصف 
۴۷۴۷" | تقوم بإنشاء صف في الجدول.حيث يتم إدخال القيم إلى الصف باستخدام النص البرمجي . 
Select‏ 


تقوم بإعادة مجموعة من الأسطر التي تطابق تعبير تصفية معين. 


<$%@ Page Language="vb" %> 

<%5@ import Namespace="Syst a 

<%@ import Namespace="Sysi ta.OleDb" $%> 
<script FEunhat="server"> 


Su EF2ce LOAM (SENCES AS OOJECE, € AS EVENLAOS) 
"declarations 

Dim mycon As OleDbConnection 

Dim mycmd As OleDbCommand 

Dim mydap As OleDbDataAdapter 


Dim mydst AS DataSet 


mycon ME OISDICOMIECELOR Û _ 
"EEO LCE ESM CTOSOL E. JOE .OLEDBS.A.OFY & | 
"Data Source=c:\myDb.mdb") 


E OM My ab e, 


mydap New OleDbDataAdapter ( 


EEE COLL, COLZ 
mycon) 
mydst = New DataSet () 
VO O cE (OVO, EOLA) 
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mygrid. DataSource = mydst.Tables ("col2") 
MVILId. Dola 


MOC SUNS 


I SEO ES 

IR ERIN > 

heads 

<title>Using DataAdapter - in dot net</title> 


</head> 


<body bgcolor="F#FFFFFFF" text="#000000"> 
<aSp6p:DalaGrid 130-mygridr" 
HOME Name Ami al EOE GSN 2e6 OE BACKCOLSOE f CECCCCEL 
wWidth="90%" Border="0" Cellpadding="5" 
runat="server" AutoGenerateColumns="False"> 
Header SELE EOE COLA 1 rEel HORN ZOMEALAIN GOM lL CeMEC E> 
<Columns> 
: BOURNACOL UMD DalaBiel dG Teo Header les 
:BoundColumn DataField="col2" HeaderText 


e 
کک‎ 2 


€ {COLTS 
</asp:DataGrid> 


</body> 
REMI 


:Da)4 1 aط[ء الغرض‎ 


يمكن الوصول إلى الجداول المحتواة في غرض 1ء5ه)ة( عن طريق الغرض عء1ط2 54)41 

الطرق الأساسية لغرض :DataRowCoI1ection¬‏ 

يوفر غرض ١10ء116٥ 0W ٣‏ ۸ه( مجموعة من الطرق لإضافة أو إزالة صفوف و لإيجاد صف بناء (01٤٥0إ٤ئصه٤)‏ على قيمة 
المفتاح الأساسي للجدول. 


الطرق الأُساسية lئغرض DataRowColIlection‏ 


الضف 
تقوم هذه الطريقة بإضافة سجل جديد تم إنشاؤه بالطريقة W‏ ٥۸ء"‏ (الخاص ب 
ما t2ه()‏ إلى الجدول 
۴۴۴ | تقوم بإزالة أغراض (412۸٠0۷‏ المحددة من الجدول 
RemoveAt‏ تقوم بإزالة سطر محدد بقيمة دليل موقعه في الجدول 
Find‏ تقوم هذه الطريق بأخذ مصفوفة من قيم المفتاح الرئيسي و تعيد الصفوف المقابلة لها في 
الجدول کأغراض 5a4 R 0W‏ 
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الطرق الأساسية لغرض :04t4 ۸0W‏ 
هذا الغرض يمتل الصف بحد ذاته ضمن الجدول و ضمن الغرض ¬ڼDataRowCollecti0.‏ 


يمتلك هذا الغرض طرق كءع ٣12١‏ مءءءA‏ و esعhan٤1ءءزRe‏ والتي تقوم بنفس العمل الذي تقوم به مثيلاتها في الغرض 
ا ا ى هذه الطرق يقم ها اترك مجمر عافن الطرق السك العامل مح الياات فى ق ولك ن 
الجدول. 

الطريقة ٍ الوصف 


8B, E4,‏ تستخدم لتحويل الصف إلى وضعية التحرير وحفظ أو إلغاء التغييرات على 
CancelEdit‏ 


۴6 تقوم بتمييز الصف كصف محذوف» و لكن لن تتم إزالته من الجدول لحين تنفيذ 


الطريقة .Update şî AcceptChanges‏ 
GetChildsRows‏ تقوم هذه الطريقة بإعادة مجموعة من الصفوف من جدول مرتبط بهذا الصف 
بعلاقة ابن. 

SetColumnError‏ تستخدم لتعيين و إعادة حالة الخطاً لهذا الصف. 
yûetColumnsInError‏ حيث تستخدم هذه الطرق مع الخصائص 12480۲8 و RowE r0۲‏ لتحري 
أو لتحديد أماكن الخطا. 


يقوم هذا المثال باستخدام الطريفة ۴١٣١‏ لإيجاد صف يحتوي قيمة محددة ثم يقوم بحذقه. 


Private Sub RemoveFoundRow (ByVal table As DataTable) 
Dim rowCollection As DataRowCollection = table. Rows 


TMESE EO SCE E EME COILEC EN OM CORNEAS EME VALE. 

TE TOMCOl lECEEIORn. COMNEAIRNS (lex LBOX1 Text) Then 
Dim foUundROow AS DalaROow  IrOWCOllIECLION.EINAd (TEXTBOX . TEXT) 
rowCollection. Remove (foundRow) 
Console.WriteLine ("Row Deleted") 


Else 


Console. WE1EeLInNe( INS SUG EOW EOUNd. £) 
End If 
EMA SUS 


الطرق الأساسية لغرض :DataRowCol1lectio¬‏ 
يمتل هذا الغرض كما ذكرنا مجموعة من الصفوف ضمن غرض ء42121( تم تحديدها بالخاصة sسه۸R‏ لهذا الغرض. 


الطرق الأساسية لغرض 0W‏ ۸ه 5: 
هذا الغرض يمتل الصف بحد ذاته ضمن الجدول وضمن الغرض ¬ټDataRowCo|11ecti0.‏ 
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Da)4 ۷1ew ه - الغرض‎ 


یمکننا تأهیل غرض 1W‏ 214۷ من خلال جدول في غرض 54486. 


يقوم الغرض (4۷1ewW‏ بالتعامل مع جدول أو مجموعة من الصفوف في جدول. یمکن إنشاءہ باستخدام الغرض ٥e۴au1 ۷1ew‏ 
الخاص بالجدول أو من خلال الغرض 44121( الذي يقوم باختيار مجموعة جزئية من الصفوف في الجدول. 


بصورة عامة إن أفضل طريقة للتعامل مع محتويات الجدول ضمن الغرض 8ة هي إنشاء غرض ۷«٠4۷1ة(‏ من الجدول 
المراد استخدامه ثم استعمال الطرق التي يوفرها: 

اة ال فت 
AddNew‏ تقوم هذه الطريقة بإضافة صف جديد إلى الغرض Wء4۷1(.‏ يمكن بعدها استخدام النلص 
البرمجي لإدراج قيم في هذا الصف. 
Delete‏ تقوم هذه الطريقة بإزالة الصف محدد من الغرض wWء۷1ه02.‏ 
‘Find‏ تأخذ هذه الطريقة كمعامل قيمة وحيدة أو مصفوفة من القيم و تعيد الدليل للصف الذي يطابق 
هذه القيم. 
)"ا۴ _ تأخذ قيمة وحيدة أو مصفوفة من القيم و تعيد مجموعة من الأغراض 12۸0۷( التي تطابق 


هذه القيم. 


مثال: 

DIM SLELSOL AS SEcine = VSSLECT * FROM ErOCUCEE SY 
Dim sda As New SqlDataAdapter (strSQL, connStr) 
Dim ds As New DatasSe 


SOA. ELLA (OS, FEEOQAUEC ENA 


Dim dv As New DataView (ds.Tables (“ProductIn!î 


Cv OEE = Prod NEMS ASC 


Cv. ROWELLEEE = IM SiEOCKE 2 100% 


Bind Ene Dalcacri d4 EO ENIS Dalla Vi eW: 
Me.dgdDemo.DataSource = dv 


کما ذکرنا مسقا يمكننا تأهيل غرض 44۷1۴۷( من خلال جدول في غرض ٥5ه)4(.‏ 
يقوم الغرض 44۷1٠۷‏ بالتعامل مع جدول أو مجموعة من الصفوف في جدول. 


Data Reader و - الغرض‎ 


توفر أغراض 041486۲ أرضية مناسبة للوصول إلى البيانات في بيئة غير متصلةء ولكن في الكثير من الحالات» وبالأخص في تلك 
التي نحتاج فيها إلى طريقة سريعة وفعالة للوصول إلى البيانات بدون الاضطرار إلى سحب جميع البيانات» 
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يعد استخدام الغرض (414۸٥2٥١‏ من أنجع الحلول لتحقيق: 


سحب سجل أو أكثر أو سحب قيم من حقول محددة 
تiفıذ‏ تعبير lٽت DELETE. UPDATE‘SQL INSERT‏ 
عندما يكون لدينا فيها كمية كبيرة من البيانات أكبر من أن تتسع لها أغراض 54456 


هناك نوعان أساسيان من الغرض ١ء‏ 4ء :544۸R‏ 
الغرض er‏ 2ء 0٥01leDb ata‏ و هو يستخدم OLE-DB‏ 
٠ه‏ الغرض 541241۸٠4٥١‏ الذي يستخدم خدمات البيانات الجدولية الخاصة بمخدم ۲٤۷ء18 SQ‏ 
يقوم الغرض ١4ء‏ 4۸اه( بننفيذ تعليمة 501 أو تخزين إجرائيات مخزنة لاستحضار مجموعة من صفوف البيانات والتجوال فيما 
بينها إذ تتم المحافظة على الاتصال مع مخزن البيانات في ذلك الوقت. 
يوفر الغرض (418۸٠246١‏ شبيه للمؤشرات المستخدمة مع مخازن البيانات والتي تستخدم تعبيرات 501 أو الإجرائيات 
المخزنة لأسخلاض مخموعة الصفوف 
يوفر الغرض 02۸٠44٥١‏ إمكانية تنفيذ تعليمات 501 أو إجرائيات مخزنة لتحديث البيانات 
لا يوفر هذا الغرض وصول غير متصل إلى البيانات 
الوصول إلى مجموعة الصفوف التي يشير إليها الغرض ١ء21٥‏ ۸ه( هو وصول مخصص للقراءة فقط و باتجاه واحد 


لاستخدام غرض (42۸4(١‏ نقوم بإنشاء غرض 000414 تم نستخدمه لتنفيذ تعبيرات 501 أو إجرائيات مخزنة و إعادة 
غرض .Data Reader‏ 
يمكننا بعدها الدوران عبر هذه الصفوف و الأعمدة باستخدام الغرض (41۸٠44٥١‏ لاستخلاص النتائج من مخزن البيانات. 


أكثر طرق الغرض 414۸٥461‏ استخداماً هي التالية: 

الطريقة | الوصف 

N۴٩‏ يقوم بدفع مؤشر الصف خطوة إلى الأمام ليؤشر إلى السطر التالي بحيث يتم الوصول إلى قيم 
الأعمدة باستخدام اسم العمود أو رقم التسلسل الخاص به. 

٥‏ | تعيد قيمة من الصف الحالي بنفس التنسيق المُستخدم في مصدر البيانات وذلك بتحديد دليل 
العمود. لتنفيذ عملية بشكل أبسط و لكن أكثر فعالية يمكن استخدام اسم العمود مباشرة و ذلك 


بالشكل . 

Value=DataReader(‘col-Name”) 

 )‏ | يقوم باعادة قيمة أو مجموعة قيم من الصف الحالي بتنسيقها الأصلي وذلك ضمن مصفوفة. 
GetXXXXXX‏ تقوم بإعادة قيمة من السطر الحالي بتنسيق نمط البيانات المحدد حسب الطريقة >>××××. 
nمٽJ GetBoolean,GetInt1 6,GetChars.‏ 

> | تقوم هذه الطريقة بنقل مؤشر الصف إلى مجموعة الصفوف الأخرى عندما تقوم تعليمة 8Q1‏ 
أو الإجرائية المخزنة بإعادة أكثر من مجموعة صفوف. تجدر الإشارة إلى أن هذه الطريقة 
ليست مشابهة للطريقة M0۷6 ٥×٤‏ لأنها لاتنتقل ضمن نفس مجموعة الصفوف بل من 


مجموعة صفوف إلى أخرى. 
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تقوم بإغلاق الغرض 01۸٠24٠١‏ و تحرير المؤشر الذي يشير إلى مجموعة الصفوف. 


SqlConnection conn = new SqlConnection(connectionString); 

SqlCommand comm = new SqlCommand('select * from mytable", conn); 

comm.Connection.Open(); 

Sq1DataReader r = 
comm.ExecuteReader(CommandBehavior.CloseConnection); 

while(r.Read()) 

{ 


Console. WriteLine(r.GetString(0)); 
a 
conn.Close() 
توفر أغراض 486( أرضية مناسبة للوصول إلى البيانات في بيئة غير متصلةء ولكن في الكثير من الحالات» وبالأخص في تلك‎ 
التي نحتاج فيها إلى طريقة سريعة و فعالة للوصول إلى البيانات بدون الاضطرار إلى سحب جميع البيانات»‎ 
يعد استخدام الغرض ١ء2٥4۸( من أنجع الحلول لتحقيق:‎ 
سحب سجل أو أكثر أو سحب قيم من حقول محددة‎ ٠ 
DELETE‘UPDATE «INSERT SQL تٽlريبعت‎ ذıiî‎ 
عندما يكون لدينا فيها كمية كبيرة من البيانات أكبر من أن تتسع لها أغراض ع5448‎ ٠ 


الوصول إلى مجموعة الصفوف التي يشير ليها الغرض ١٥44ء‏ ۸ه( هو وصول مخصص للقراءة فقط وباتجاه واحد. 


متی یجب استخدام غرض ۲ء04۸2 ومتی یجب استخدام غرض 2)8٥‏ 5: 
٠‏ عند البدء ببناء تطبيقاتنا للوصول إلى مخازن البيانات» يجب علينا أن نفكر بنوع الوصول الذي نريد وكيف سيتم استعمال 
البيانات 
لا بد وأنه أصبح من الواضح مما ذكرناه مسبقاً أن أغراض 0186 تسبب حمل وتعقيد لا يمكن إهماله مقارنة مع الغرض 
DataReader‏ من حيث الأداء واستهلاك الذاكرة. إا لا بد لنا من التركيز على استخدام الغرض ۲ء 2ء۸ ٥a4‏ غو شا عن 
DataSet‏ 


هناك بعض الحالات التي لا يمكن فيها الاستغناء عن 56هa)ة0‏ وهي: 

٠‏ عند حاجتنا إلى استخدام البيانات بشكل غير متصل مع مخزن البيانات و تمرير هذه البيانات إلى أطر أخرى ضمن التطبيق»› 
وتخزينها » وتحريرها 
عند الحاجة إلى تخزين» ونقلء والوصول إلى أكثر من جدول (أكثر من غرض ء1ط١04121)‏ ومعالجة العلاقات بين هذه 
الجداول 
عند الحاجة إلى تحديث البيانات في قاعدة البيانات باستخدام طرق خاصة بغرض )0)8 و ۲ء م4 ل414 عوضاً عن 
استخدام تعبیر ات 0۲2۸41۴ 5Q1‏ أو استخدام الإجرائيات المخزنة 

٠‏ عند الحاجة لإدارة الوضع بشكل أفضل في بيئة متعددة المستخدمين 
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عندما نريد الاستفادة من المزامنة بين وثائق ۷1× و مجموعة الصفوف العلائقية المقابلة 
في بعض حالات الربط مع عناصر التحكم مثل حالات الربط مع أكثر من عنصر في نفس الوقت» أو تقسيم السجلات إلى 
صفحات في عنصر تحكم ل4461 إذ نستخدم في هذه الحالة الغرض 414۷1۷( المنشاً من جدول في غرض 
DataSet‏ 

في حال أردنا الدوران ضمن صفوف البيانات وأردنا الحصول على حرية في اتجاه الحركة للأمام أو الخلف. هنا أيضا لا 
يمكننا استخدام الغرض 1ع 2ء Data R۸‏ 


متی یجب استخدام غرض 04)٩۸ ٥44٥۲‏ ومتی یجب استخدام غرض 4)45 5: 


٠‏ عند البدء ببناء تطبيقاتنا للوصول إلى مخازن البيانات» يجب علينا أن نفكر بنوع الوصول الذي نريد وكيف سيتم استعمال 
البيانات 
لا بد وأنه أصبح من الواضح مما ذكرناه مسبقاً أن أغراض 0186 تسبب حمل وتعقيد لا يمكن إهماله مقارنة مع الغرض 
DataReader‏ من حيث الأداء و استهلاك الذاكرة. إا لابد لنا من التركيز على استخدام الغرض ء4٠44۸(‏ عو ضاً عن 
DataSet‏ 


مزودات البيانات العلائقية في N٤1‏ 
كما رأینا سابقا تستخدم .N٤۲‏ مزودات بيانات للاتصال بمخازن البيانات. يوفر إطار عمل .N8١‏ دعم لمجموعة المزودات التالية: 
اسم المزود الوصف 
SQLServer J OLE-DB دgjn SQLOLEDB‏ 
ORACLE J OLE-DB دgja MSDAORA‏ 
Microsoft.Jet.OLEDB.4.0‏ مزود 018-58 ل ءءعء٥۸‏ مصادر البيانات التي 


تستخدم مزود ا[ 


تقدم .N NET‏ أيضاً المزود 028٥‏ الذي تم تطويره ليسمح بالاتصال بالعديد من التجهيزات و مخازن البيانات» وهو يستخدم أغراض 


مشابهة لتلك المستخدمة مع المزودات الأخر ى فهو يتضjn‏ مأ «OdbcDataReader «OdbcCommand «OdbcConnection‏ 
l!...OdbcDataAdapterخ.‏ 

تقدم 81. أيضاً المزود 028٣‏ الذي تم تطويره ليسمح بالاتصال بالعديد من التجهيزات ومخازن البيانات» وهو يستخدم أغراض 
مشابهة لتلك المستخدمة مع المزودات الأخرى. 


أمثلة 


<$%5@ Import Namespace="System.Data.OleDb" %> 

<script runat="server"> 

SUS Eage LOA 

JAM COCO 

dJHeonn New OlEDOCONNeECE1 ON (LBEOVIGdEr Mi CEOSOE E . JE . OLE 
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data source=" & server.mappath ("northwind.mdb™") ) 
dbconn. Open () 

end sub 

SV SENSO, 


<%5@ Import Namespace="System.Data.OleDb" %> 

<SEFEipt runat="server"> 

sub Page Load 

CAN CIOCOAN , SOL, CUOCOMS 

dJOEoOnNn New OLEDOCONNE CEO (LEEOVIAE E MiEFOSO EE. Te E OLE 
data source=" & server.mappath ("northwind.mdb™") ) 
dbconn. Open () 
SEL = SRLUCTE = OROM CUSTOMS ES 
dbcomm=New OleDbCommand (sql, dbconn) 
end sub 
SV SEO 


<$%5@ Import Namespace="System.Data.OleDb" %> 

<script runat="server"> 

SUS Hage LOAd 

dim dbconn, sql, dbcomm, dbread 

dE New OLEDOSCORNE CE EON LEEOVIGEE MiEFOSO EE Te E OME 
dalEa SOUKGe ll & SERVET .TMAPPa ED ( CMO E Mu MA MAO) ) 
dbconn. Open () 
SEL =VSRLUCTE = ROM CUSTOMS SY 
dbcomm=New OleDbCommand (sql, dbconn) 
dbread=dbcomm. ExecuteReader () 

end sub 
€< SELLOIEZ 


<$%$@Page Language="VB" %> 


IMEC E MAME SPASE SEEM. AEA > 
Import Namespace="System.Data.OleDb" %> 


<1DOCTIPE HTML, PUBLIC = WC DID HINL 4.0 TransilLlonal/ ENT 
<html><head> 
<title>The .NI taSet and OleDbDataAdapter Objects</title> 
€= INCI EAS. OLOOALNE LYLE. ICY => 

</head> 
<body bgcolor="# E> 

<span class="heading">The .NET DataSet and OleDbDataAdapter 
Objects</span><hr /> 


COIVZCONNELCEION SETTING: SD CSA II POUECONNECET 
runat="server"></span></b></div> 
<div>SELECT command: <b><span id="outSelect" 
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runat="server"></span></b></div> 
Ev ME OEE EOEL UNAE See EL CROSS, OAM 


<asp:datagrid id="dgrResult" runat="server" /> 


<script language="vb" runat="server"> 


Sub Page Load() 


'get connection string from web.config file 

Dim SIrCoNNECE AS Slring 

strConnect = ConfigurationSettings.AppSettings ("DsnWroxBooksJet"™) 
& RECUMESE. EAVSLEALAOOLLEAELORPAED | 

& "databases\WroxBooks .mdb" 

OULCONNECL.INTETTEeELL = SIrCONNECL ANd diSblay 1L 


'specify the SELECT statement to extract the data 
Dim SESeleSGE AS SERIN 
SESE lECE  LSEUECL : HROM BOOKLUSE MHBERE TOSBN LIKE OOS ET 
outSelect.innerText = strSelect "and CiSplay E 


'declare a variable to hold a DataSet object 
'note that we have to create it outside the Try..Catch block 
'as this is a separate block and so is a different scope 

Dim objJDataSet As New DataSet () 


EY 


'create a new Connection object using the connection string 
Dim objConnect As New OleDbConnection (strConnect) 


'create a new DataAdapter using the connection object and select 
LE LENE ME 
Dim objJDataAdapter As New OleDbDataAdapter (strSelect, objConnect) 


"fill the dataset with data from the DataAdapter object 
objDataAdapter.Fill (objDataSet, "Books") 


CaECh OBDFEETOE AS EXCEL ION 


'display error details 
OUEAE LOLc TANE AML = WoO Mirror WALLIS HECI AACA. S4 


S&S ODN EEEOE Message GS <O >1 & OOJHEEOB. SOUECE 
Sub ' and stop execution 
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E Ey 


'create a Dataview object for the Books table in the DataSet 
Dim objDataView As New DataView (objDataSet. Tables ("Books") ) 


"assign the Dataview object to the DataGrid control 
dgrResult.DataSource = objDataVview 
dgrResult.DataBind () "and Onda (Oi SSlaAY) Eme daka 


BME! SUIS 
GJ SEEIOEZ 


lI == Fine EALeE= . NOLO NE 
</body> 
MEMS 


Dim ds As New DataSet () 


DIM SLES As SEring = SELECT CSE ID, OEE I, 3 & | 
"Order Date FROM Orcers WHERE Year (OFCEE Dace) => 19910" 

Dim oda As New OleDbDataAdapter (strSQL, connStr) 

GOA. EAL (OS, OEE LM EO) 


SEESOL  NSEUMCETE CUSE OMe E ID EROM CUSEOMeEES E 
ORDER BEY CUS e ome r NDI 

Dim sda As New SqlDataAdapter (strSQL, connStr) 

sda.Fill (ds, "CustomerInfo") 


DI CCL AS Detacolmn = | 

ds. Tables ("CustomerInfo") .Columns ("CustomerId" ) 
Di CECZ AS DataColumm = | 

ds.Tables ("OrderInfo") .Columns ("Cust _ Id") 


Dim dr As New DataRelation ("CustomersToOrders", dcl, dc2) 
ds.Relations.Add (dr) 


Dim drCustomer As DataRow 
Dim drOrder As DataRow 


HOE Haeh dECUSEOMEeE IM AS. lal eS (LCUSEOMe EL 
J1 SEDEME. 1ERS . ACC (CEUSEOMEES ¥ E | 

dEE US E OMEE (CUS EOMeE ETAL) TOS EER ()) 

' TIterate through related rows. 

HOE Hale GAEOEdeE MIM QAECUSEOMEE CE EERE LOARONS (OE) 
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J SEDEMO . LESS , ACEC | 
CLETING.EOTMaAL (F Order (U Blaced Cn (IO, 
GOECE E (HOCEEE IDF), CEOEAEr (OEEE Dale) 
Next drOrder 
Next drCustomer 


مقدمة عن XM‏ في NET‏ 


تكلمنا سابقاً عن المزايا الجديدة في إطار العمل .NE١‏ والمخصصة للوصول إلى البيانات العلائقية وقمنا بمقارنة بسيطة مع التقنيات 
التقليدية التي كانت مستخدمة مع ۸50. 


أصبحت لغة ۷1× وبسرعة» اللغة الأساسية على الوب وتم اعتمادها من قبل العديد من التطبيقات. لذا سنركز فى هذا الجزء 
وبسر : وتم من يد من : سنرکز في 
الطريقة التي تدعم بها .×٤1‏ لغةڌ اM×.‏ 


أغراض ×۷× الأساسية في :).×N٤1(‏ 
قدمت منظمة ۷30٥‏ مجموعة من المعايير التي حددت البنية والواجهات التي يجب تزويد التطبيقات بها للوصول إلى وثائق ا١×.‏ 


تسمی هذه المعايير _- .(DOM)‏ 


وقد تبنت .N٤1‏ دعم هذه المعايير مj‏ خlاJ‏ !)غر اض Xm1Document‏ 
.XmlDataDocument ş‏ 


توفر هذه الأغراض دعماً كاملا لمعايير (0 50 ا۷) من الدرجة الثانية. 
وسعت .N٤1‏ دعمها ل ۷× عبر تقديم تقنيات للتعامل مع وثائق ۷1× وهياكل ۷1× وملفات الأنماط. 


تتوز ع أغراض ۷1× الأساسية في ثلاث مجموعات: 


المجموعة الأولى لقراءة وكتابة وتحويل ملفات ا۷ وتتضمن هذه المجمو عة غراض XmlTextWriter y Xm1TextReader‏ 
و Xml|NodeReader‏ إضافة إلى غرض ١٣f0۲ومه١إ11ء>‏ الخاص بإنشاء ملف بتنسيق مختلف عن وثيقة ۷1× الأصلية. 


المجموعة الثانية خاصة بتخزين وثائق ۷1× والتعامل معها وهي تتضمن الأغراض مثل )100101ص 


.XPathDocument «XmlDataDocument 
.XPathNavigat0r و نستخدم فيها الغرض‎ ×١] المجموعة التالثة خاصة باستعلام‎ 


سنلاحظ تداخل بين هذه الوظائف. فلاختبار وثيقة ۷1× أثناء قراءتهاء نستخدم الغرض e4‏ 1۸ا2 ل1اة 1۷× و هناك أغراض 
أخری لانشاء و تحریر هیاکل و مخططات ۷1×. کما یمکننا أیضا استخدام الغرض ٣٤۴0۲۳٣‏ 1۲۲۵ء× لتتفيذ استعلام على وثيقة 
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بالإضافة إلى تحويلها إلى تنسيق مختلف. 
وسعت ..٤۲‏ دعمها ل ۷1× عبر تقديم تقنيات للتعامل مع وثائق ا۷×» وهياكل ۷1× وملفات الأنماط. 


غر اض Document‏ 


لدينا ثلاث آليات تطبيقية لغرض 1ع" :50cu‏ 


الغرض ١عدuء0‏ 10× : هو عبارة عن آلية تطبيق ."٥‏ لمعايير 00۳. تتضمن خصائص وطرق هذا الغرض تلك 
المعرفة من قبل ۷3٥‏ للتعامل مع وثائق ۷1× مع بعض الإضافات لجعل العمليات الأساسية أسهل. 

الغرض Xm1D(ata(0cu 2٤1‏ : هو عبارة عن امتداد للغرض 10001٥1۲‏ × يوفر نفس مجمو عة الخصائص 
والطرق» كما يعمل كجسر وصل بين ]۷× وطرائق قواعد البيانات العلائقية. 

الغرض 0٥٠"١‏ 00× : يمثل آلية سريعة لتخزين وثائق 11× وهو مصمم خصيصاً ليتم الوصول إليه باستخدام 
الغرض ١0اهعN2۷1 ۴a1‏ باستعمال استعلامات ۴1× فقط أو الملاحة ضمن الوثيقة عنصر تلو الآخر باستخدام تقنية 


. “Pull” 


الطرق الأساسية لأغراض :500u e1‏ 


الطريقة 


Createxxxxxx‏ تقوم بإنشاء عقدة في وقة XML‏ اعتماداً على اسم الطريقةء مثل 


Element تقوم بإنشاء نسخة مثيلة عن عقدة 1× مثل نسخة من عقدة‎ CloneNode 
تقوم بإعادة عقدة وحيدة باستخدام قيمة الواصفة 10 كمعامل.‎ | 1eme 4 
تقوم بإعادة عقدة وحيدة باستخدام اسم التأشيرة كمعامل‎ GetElementsByTagname 


خl]...CreateTextNode‎ «CreateComment «CreateElement 


¥ يمتلك الغرض ئD0ocun¬en XPath‏ رقا عامة ذات فائدة غير الطريقة 0۲أةع2۷1ل١ع C۲٠2‏ كونه مصمم ليعمل فقط مع الغرض 
XPathNavigator‏ 


في حين يوفر النوعان الآخران لغرض ١ءدصuءه(‏ مجموعة كاملة من الطرق والخصائص وهي تلك المحددة في معايير W3٤٧‏ 


DOM 


إضافة لما ذكر يوفر هذان النوعان مجموعة مفيدة من الطرق والخصائص التي تستخدم بشكل كبير للعمل مع وثائق ۷1× وهي 
تتضمن طرق لإنشاء أنواع معينة من العقد والوصول إلى عقد موجودة 
هناك أيضا مجموعة من الطرق لتحميل وحفظ ۷1× من وإلى غرض وثيقة ۷1×. 


Save 


ReadNode 


تقوم بحفظ وثيقة ۷1× كاملة إلى ملف على القرص أو إلى غرض 51٥4۳١‏ أو إلىغرض 
.XmlTextWriter‏ 


تقوم بتحميل عقدة من وثيقة ۷1× يجري التأشير إليها بغرض ×_1۲١×۲۸ ٥44٥۲‏ أو غرض 
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.XmINodeReader 

×1۲ e× W1) ء١ يجري التأشير إليها بغرض‎ ×١1 تقوم بكتابة عقدة إلى وثيقة‎ WriteTo 
تقوم بكتابة عقدة وكل ما يندرج تحتها إلى وثيقة ۷1× أخرى يجري التأشير إليها بغرض‎ | Write nt e060 
.XmlTextWrite 


أما إذا أردنا استعمال الغرض ١0اةع۷1‏ ط۴× في وثيقتنا فإننا نقوم بإنشاءه باستخدام الطريقة :CreateNavigator‏ 
الطريقة الوصف 
CreateNavigator‏ تقوم بإنشاء و إعادة غرض ١٥20عN2۷1طاة۴×‏ مبني على وثيقة ۷1 الحالية. 


يمكن تطبيقه على جميع أنواع أغراض D0¢u me‏ . و ڙزg XmlDocument‏ 
و Xm 1DataDocument‏ تقبل هذه الطريقة معامل إضافي يشكل مؤشر إلى 
عقدة في الوثيقة و التي ستكون موقع البداية لغرض XPath Navigator‏ 


يدعم غرض 1ع (0u‏ ها12aص×‏ خاصة إضافية عن الخصائص يقدمها الغرض 1ع 100cuص×‏ : 
الفا اأفف 
4 تقوم بإعادة محتوى وثيقة 1× كغرض 54286 . 


كذلك يدعم الغرض X121220٠ ٥١‏ طريقتين إضافيتين توفران وصول أقوى إلى محتوى الوثيقة و ذلك بالتعامل معها 
كمجموعة صفوف أو جدول بيانات. 

الطريقة ا 
GetRowFromElement‏ يعيد غرض 4۸0۷( يمثل العناصر في الوثيقة. 


GetElementFromRow‏ یعید غرض 1٥1ء1۴1‏ × یمتل س44۸0 في 


جدول ضمن ع5248 


XPathNavigator ائغرض‎ 


لجعل العمل مع وثائق ۷× أسهل تم تعريف الغرض ١20ع1 N4۷‏ ۴1× في فضاء الأسماء اص×.٠ءاءر؟‏ والذي 

يمكن استخدامه للتجوال ضمن وثيقة ۷1× أو للاستعلام عن مكون ضمن الوثيقة باستخدام تعبير ۴4× 

نشير إلى أنه يمكننا استخدام الغرض 20۲ XPat1 Nav 1g‏ مع أي غرض وثيقة ۷1× ولیس فقط مع .XPath Document‏ 
أي يمكننا إنشاء غرض ١20عN2۷1طاه۴×‏ مبني علی غرض XM [00u ne1‏ أو علی غرض 
XmlDataDocument‏ 

يقدم الغرض ١40ع۴411[3۷1×‏ مجموعة من الطرق و الخصائص التي تسمح بالتجول ضمن وثيقة ۷1× كالانتقال بين 
العقد بالترتيب أو بتجاوز العقد حتى الوصول إلى عقدة من نمط معين 

يقدم الغرض ١0اهع1[N3۷1ة۴×‏ مجموعة من الطرق التي تقبل تعبيرات ۴1> أواسم العقدةء أونمط العقدةء وتعيد العقدة 
أو مجموعة العقد المطابقة. عندها نستطيع التجوال عبر هذه العقد 


يمكن إنشاء الغرض ١٥20ع‏ ۷1ةلN[طاهة۴×‏ فقط من غرض وثيقة موجود و ذلك كما بلي: 
Dim objNavl As XPathNavigator = objXMLDoc.CreateNavigator ()‏ 
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Dim objNav2 As XPathNavigat = objJXMLDataDoc.CreateNavigator () 
Dim objNav3 As XPathNavigat = objXPathDoc.CreateNavigator () 


يسمح هذا الغرض بالتجوال عبر الوثيقة واختيار عقدة ضمن وثيقة 1× والوصول إليها 

يمكننا إنشاء أكثر من غرض من هذا النوع على نفس الوثيقة ومقارنة مواقعها 

لتحرير وثيقة ۷1× نستخدم مؤشراً إلى العقدة الحالية لهذا الغرض أو غرض ١0هإآءل‏ ط۴× الذي يحتوي أكثر 
من مجموعة من العقدء ونقوم باستدعاء الطرق الخاصة بعقدة ما من المجموعة 

في نفس الوقت يوفر الغرض ١0هع۷1هN[‏ ط۴× تفاصيل حول العقدة الحالية وبهذا يكون لدينا طريقتان للوصول إلى 


معلو مات عة ما ضنمن الوشقة 


هناك طرق للحركة ضمن الوثيقة لجعل عقدة ما هي العقدة الحالية بالنسبة لغرض ١0اهع‏ ۷ة ط۴× أو لإنشاء غرض 
XPathNavigator‏ جدید: 

الطريقة الورصف 
×××××*×10۷۴10 | يقوم بتحريك موقع الغرض ضمن وثيقة M1‏ × الحالية. لد مڈ: Move ToFirst‏ 


,MoveToRoot ,MoveToAttribute, 
moveToParent, MoveToFirstChild 


إنشاء غرض ١20ع۴21[N2۷1×‏ جديد متوضع في نفس المكان الذي يتوضع فيه 


غرض الحالي 20۲ ع ۷1هل طاه۴× ضمن الوثيقة. 


هناك أيضاً طرق مخصصة للوصول و اختيار أجزاء من محتوى وثيقة: 
الطريقة 0 
GetAttribute‏ تقوم بإعادة القيمة المحددة المعامل اأ من العقدة الحالية ا 


| تعيد غرض 40۲إ٥)[ء‏ ۴1× الذي يحتوي مجموعة من العقد التي تطابق 
التعبير طXPat×.‏ 

خ۴ | تعيد هذه الطريقة غرض ۲4٥1ء‏ هطه۴× الحاوي على مجموعة من جميع 
عقد السلف في الوتيقة والتي لها نمط معين واسم معين. 

ئْؤْaٍ SeetDescend‏ تعيد غرض a0إe† XPath Node]‏ يحتوي مجموعة من العقد المتحدرة من الوثيقة 
والتي لها نمط معين أواسم معين. 

SelectChildren‏ تعید غرض ۲20۲ XPath N0 e12‏ يحتوي مجموعة من العقد الأبناء من نمط معين 
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Xml TextWriter ضرغئl‎ 


٠‏ عند استخدام الغرض 10001061 × لإنشاء وثيقة 11× جديدة يجب علينا إنشاء أجزاء وإدراجها ضمن الوثيقة بطريقة 


معينةء وهي طريقة قد تكون معقدة ومصدر للخطأ. 


٠‏ يمكن للغرض W١‏ 1× أن يُستخدم لإنشاء وثيقة ۷1× عقدة تلو الأخرى بطريقة تسلسلية بكتابة التأشيرات والمحتوى إلى 
الخ رج اكام مجمرعة الطرق اللي بها هذا القرضن 
٠‏ يأخذ الغرض ١×۷ !1٥۲‏ 1۲× كمصدر» إما غرض ١١٤زا ٠١×۷‏ الذي يوشر إلى ملف على القرص» ومسار»ء واسم هذا 
الملف» أوغرض 51:٠4۳‏ الذي يحتوي وثيقة ×١1‏ جديدة 
ه يقدم هذا الغرض مجموعة من الخصائص و الطرق التي يمكن استخدامها لإنشاء عقد ا۷ و محتويات أخرىء» ثم يقوم 
بتوجيه الخرج إلى ملف على القرص أو غرض 5۲۴4۳١‏ بصورة مباشرة 


X1۲ ex W١ كأداة خر ج لطرق في أغراض متعددة حيث يقوم غرض‎ ×1١ ٠١×W ا٤١١ يمكن أن يتم تعيين الغرض‎ ٠ 
Streaı1 أو غرض‎ ۲١×١ بتوجيه المحتوى إلى ملف على القرص أو غرض‎ 


اكثر الطرق استخداماً لهذا الغرض هي التالية: 

الظربةة EF‏ 
WriteStartDocument‏ تقوم ببداً و ثيقة جديدة وكتابة تصريح ۷1× إلى الخرج. 
WriteEndDocument‏ تقوم بإنهاء الوثيقة بإغلاق جميع العناصر غير المغلقة ثم إرسال المحتوى إلى 
الخر 
WriteStartElement‏ تقوم بفتح تأشيرة لعنصر محدد. عندها يمكن البدء بإنشاء الواصفات باستخدام 
اÛJطر‏ يãقة WriteStartA ttri bute‏ 
Write EndElement‏ تقوم بكتابة تأشيرة إغلاق للعنصر الحالي. الطريقة المقابلة لإغلاق واصفة هي 
.WriteEndAttribute‏ 


Write ElementString‏ تقوم بكتابة عنصر كامل (بما يتضمن تأشيرات الفتح و الإغلاق) باستخدام 
سلسة محارف كقيمة. الطريقة المقابلة لأداء نفس العلم مع الواصفات هي 
WriteAttributeString‏ . 

تقوم بإغلاق الملف على القرص أو غرض 51٥4٠١‏ و تحرر جميع المؤشرات 
المرتبطة. 


XmIReader انلغرض‎ 


ه نحتاج في بعض الأحيان إلى قراءة وثاتق ۷× من مصدر آخر عوضاً عن كتابتها 
٠‏ يعتبر الغرض ۲٤21ء‏ 1۸× صف قاعدي يرٿ منه صفان عlمjl XmINodeReader , XmlTextReader laa‏ 
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يعتمد الغرض ل4٠ ×.11٠×1۸‏ على الغرض ١ءله٠ 1١×۸8‏ الذي يؤشر إلى ملف ۷1× على القرص» وإلى مساره واسمه أوإلى 
غرض 8۲٥4٠١‏ يحتوي وثيقة ۷11×. يمكن قراءة محتوى الوثيقة عقدة تلو الأخرى» ويوفر الغرض معلومات حول كل عقدة و حول 
القيمة التي تحتويها أثناء قراءتها. 


يأخذ الغرض XmlIlNodeReader‏ غرضص XmlINode‏ کمصدر له مما يسمح بقراءة جزء من وثيقة XML‏ عو ضا عن قراءة کامل 
فة فى حال كان سف ا لرضون لى عة مه وى العف اع ف اة 


ه٠‏ يمكن أن يُستخدم الغرضان X11 e×8 e2۲‏ و Xm ]NodeReader‏ بصورة منفصلة لتوفير وصول سریع وفعال 
لوثائق ۷× أو كمصدر لأغراض أخرى حيث نقوم تلقائيا بقراءة الوثيقة وتمرير ناتج القراءة إلى الغرض الأب 
تستخدم الأغراض XPath Nav iعaأ0 ١‏ و Xml! rextReader‏ نمذجة ”11م“ للوصول إلى البيانات عقدة تلو الأخرى 


عوضا عن تفريغ كامل الوتيقة كشجرة ضمن الذاكرة. يسمح ذلك بالوصول إلى ملفات كبيرة الحجم دون استهلاك الكثير من 
الموارد ويجعل عملية كتابة النص البرمجي أسهل في أغلب الحالات. 
كما تبرز أهمية هذه الأغراض في الحالات التي نبحث فيها عن قيمة معينة عندها لن نضطر إلى قراءة كامل الوثيقة بل 
يمكننا الوصول إلى عقدة محددة بعد قراءة جزء من الوثيقة 
يمتلك الغرضان X11 e×8 2de‏ و Xm|NodeR ader‏ خصائص و طرق متطابقة تقريباًء أهم الطرق المستخدمة هي: 
الوصف 
۴٩۵‏ تقوم بقراءة العقدة التالية إلى الغرض حيث يمكن الوصول إليها. تعيد القيمة #ءاه۴ 
عندما لا يتبقى أي عقد لقراءتها. 
ReadInnerXml‏ تقوم بقراءة وإعادة محتوى العقدة بشكل سلسلة محارف بما فيها جميع التأشيرات 
والنصوص للعقد الأبناء. 
ReadOuterXml‏ تقوم بقراءة وإعادة محتوى وتأشيرات العقدة الحالية كسلسلة محارف بما فيها جميع 
التأشيرات والنصوص للعقد الأبناء . 
ReadString‏ تقوم بإعادة سلسلة محارف تحتوي قيمة العقدة الحالية. 
ئا | تقوم بإعادة قيمة الواصفة المحددة للعقدة الحالية لغرض ١ء‏ ل2 X1۸‏ 
GetRemainder‏ تقوم بقراءة و إعادة الجزء الباقي من وثيقة ۷1× المصدرية كسلسلة محارف و تعد 
هذه الطريقة مفيدة عندما نرغب بنقل ۷1× من وثيقة إلى أخرى. 
MoveToxxxxxx‏ تقوم بنقل موقع مؤشر llتlرئ.‏ aةڻJl: MoveToContent s MoveToAttribute‏ 
ڪ MoveToElement‏ 
۴ | تقوم بتجاوز العقدة الحالية والتحرك إلى العقدة التالية. 
8 | تقوم بإغلاق الملف على القرص أو إغلاق الغرض S۲٠2۳‏ الذي يتم التعامل معه. 
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XMLValidating Reader ضرغئl‎ 


:XMLValidatingReader ضرغنl‎ 


هناك غرض آخر مبني على الصف ١ء‏ ل4 1۸× وهو الغرض ١4ء‏ ۸ع١1اه‏ 1اه .×m1۷‏ يمكننا النظر إلى هذا الغرض 
كغرض له ۸×١١1ص×‏ ولكن بمهمة تقييم وثيقة مقارنة بهيكل أو بمخطط ما 

يمكننا إنشاء غرض Xn 1۷ ا11١۸ e41‏ من غرض e4١‏ 1۸× موجود» أو من غرض 51:٥4۳‏ أو من سلسلة 
محارف تحتوي 11× ليتم تقييمها والتحقق منها 


:Xs]1 Transforٿ¬ الغرض‎ 


×XM1 تعتبر الحاجة إلى تحويل الوثيقة باستخدام 81× أو 11؟× من أهم متطلبات العمل مع وثائق‎ ٠ 
XSTL yi XSL لإجراء عمليات التحويل باستخدام‎ EE 11ء× المصمم‎ ۲١ھ‎ ۸٤٤٥۲۳٣ الغرض‎ .J' ٤1 تقدم‎ ۰ 


تقدم 1۲۲۵۹۴0۲۳ء× طریقتین اُساسیتین هما: 


الطريقة الوصف 
08 تقوم بتحميل وثيقة أنساط ا8 و يتم التأشير إلى أي 
وثيقة أنماط باستخدام 1udeءمxs1:1‏ 


×81 تقوم بتحويل بيانات وثيقة 1× محددقاستخدام‎ Transform 


أو 17× و تقوم بإخراج الناتج. 


llغرض XMLValidatingReader‏ : 
ه هناك غرض آخر مبني على الصف 2e۲‏ 1۸× و هو الغرض .Xm1Validating Reader‏ 
يمكننا النظر إلى هذا الغرض كغرض ١ءله٠۸×١1×‏ و لكن بمهمة تقييم وثيقة مقارنة بهيكل أو بمخطط ما 
يمكننا إنشاء غرض X1۷ a1id a1۸ e21‏ من غرض آله 1۸× موجود» أو من غرض ١۳ه٠5)۲»‏ أو من سلسلة 
محارف تحتوي ۷1× ليتم تقييمها و التحقق منها 
الغرض :xsI Tra nsf0٥۲rı”۸‏ 
٠‏ تعتبر الحاجة إلى تحويل الوثيقة باستخدام 81× أو S11؟×‏ من أهم متطلبات العمل مع وثائق ×XM1‏ 
۰ تقدم N۴1‏ . الغرض ٣٤۴٥۲۳٣‏ ۵إ11ء× المصمم خصيصاً لإجراء عمليات التحويل باستخدام 81× أو XSTL‏ 
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أمثلة 


نلاحظ في هذا المثال أننا استخدمنا الغرض ٥١‏ uع‏ 00|" × ثم قمنا بتحميل ملف إليه بالطريقة 1030 وبعدها قمنا باستخدام 
الطريقة ١2۳6‏ ۸8/۲29٠ص‏ eاع‏ اه لإيجاد جميع العقد التي يكون اسم التأشيرة فيا هو “Authner N2۳6٥”‏ تم قمنا بالدوران 
ضمن النتائج و إظهارها. 


<%@Page Language="VB" %> 
<$S@Import Namespace="System.XML" %> 


€ I DOCTYEE HTL BUELLE = MIC /DID EL 4.0 Transitional 7/1 
<html><head> 
<title>Searching an XML document using the DOM</title> 
lI == INCLU EILEEN. e NOLOOAINEL VLE. IMEY => 

</head> 
OO OOCOLOE=S E> 

<span class="heading">Searching an XML document using the DOM</span><hr 


GEL LO=WOUEDOCURLY UNAL SCETEEUES< 7 OAVS 
iv AM CUETO UNAE Sever CROSSE, AU 
E ME OMER E SUES Uma E SE ve E > CAO 


<script language="vb" runat="server"> 


Sub Page Load() 


"cereale physical path t6 Booklist. xml Sample fIleê (n same folder as 
ASE ECE 
Dim SEFEUrEEREEAERN AS SEIN  MEQGUESE. EMSA CA LEANER 
Dim SEEXMLEAEN AS SEEINS Ue E(SEEOUEEENEEAEN, 
TASE REV (SIE FOUEE ERE EAE, N) E BDOOKIISE XML 


'create a new XMLDocument object 
Dim objJXMLDoOc As New XmlDocument () 


EY 


'load the XML file into the XMLDocument object 
objXMLDocC. Load (strXMLPath) 
GUEDOCURL.InnerHIMTL = "loaded File: <b>" & SILrXMIPaLh € SDT 


Catch GDF EEO As Ezcebtion 


'display error details 
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IE SIE ¢ E MM = Eos MOE WNN lS ECCS S I MC COC UME ¥ (S> ¢ IKE 


& ObJErrFOr. Message & "<Br />" & ODJEFEOL .SOULCE 
LL Sub ' and stop execution 


OGL TE 


'now ready to parse the XML document 
'it must be well-formed to have loaded withou 


"cereale a Slring Io hold the matching values found 
Dim SEEREeE SUES AS SESING - LCOS OE AUEMNORSSAO SOE el 


'create a NodeLlList collection of all matching child nodes 
Dim colElements As XmlNodeLlist 
colElements = objXMLDoc.GetElementsByTagname ("AuthorName" ) 


"iterate through the collection getting the values of the 
"child #text nodes for each one 
Dim objNode As XmlNode 
For Each objNode In colElements 

strResults += objNode.FirstChild() .Value & "<br />" 
Next 


'then display the result 
outResults.innerHTML = strResults display The result 


NEL SUS 


SE OIE 


</body> 
VM Em 


في المثال التالي سنقوم باستخدام غرض "|00٥1 "€١‏ × ثم تحميل وثيقة 1× إليه بواسطة الطريقة ٥2٩١‏ ا. 
قمنا بتعريف تابع ليقوم بإعادة نوع العقدة ضمن الوثيقة بناءاً على الرقم الذي تعيده الطريقة #مر١ءل0.‏ 


ثم قمنا بتعريف تابع آخر يقوم باستعراض العقد وفحص العقد الأبناء لكل عقدة. 


<S@Page Language="VB" %> 
<$S@Import Namespace="System.XML" %> 


€ DOCTEEE HTML BUSLIE "=7 MIC//DID HMC 4.0 Transitional 7/7! 
<html><head> 

EEE ACEC SSIS CME Ioeumenes USING Ehe DOM E EEE 
l= INCI EIS. NOLIOSALNEEYLE. IRC > 
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</head> 
<body bgcolor="# 


RS 


<span class="heading">Accessing XML documents using the DOM</span><hr 


GEO AES OU EDOCURLY TUNIC SC VOLES OAV 
GEN 1E=POUEMEEOEN EUSA E—=N SEES CUSED S/O T> 
di ME OUERESTUUE SE EUNaA E Seve EL > I> 


<script language="vb" runat="server"> 


Sub Page Load() 


'create physical path to booklist.xml sample file (in same folder as 
AGE OCS 
Dim SEE UEEEREEAERN AS SEMI  MeQUESE. ERVSTEA LEA ER 
Dim SES MEEaE N AS GELANI We E(SETREUEEERE EAE My, 
INSEL EREV (SEECUL TONLE PACA, ND & UOOOELISE ¢ ML 


'create a new XMLDocument object 
Dim objXMLDoOoc As New XMLDocument () 


Ey 


'load the XML file into the XMLDocument object 
objJXMLDOoC. Load (strXMLPath) 
GULDOCURL.InncTITME = "loaded Tile: <F" CEC SET IMIPATLD G&G DT 


CalLCh GOBDIETIGE AS ECEDLION 


'display error details 
Error.innerHTML = "<þb>* Error while accessing document</b>. 


& objJError.Message & "<br />" & objJError. Source 
Sub ' and stop execution 


MME EY 


"now ready to parse the XML document 

"itl must be well-formed to have loaded without error 

'call a recursive function to iterate through all the nodes 

'in the document creating a string that is placed in the <div> above 

DIM SITNOIES £ SITING 

outResults.innerHTML = strNodes & 
GetChildNodes (objXMLDoOc.ChildNodes, 0) 
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Function GetChildNodes (objNodelList As XMLNodelist, intLlLevel As 1 
AS SGIEING 


DAM SENOS eES AS SE O ll 
Dim objNode As XMLNode 
Dim obğJAttr As XMLAttribute 


"iterate through all the child nodes for the current node 
FOE Each ObINode In O6 INOdELISE 


Si Slay AME Oma EAOn aSOUE EMIS MOE 
SE ENOGES = SErMNOCSS & COCIMCENE (MELEYE) _ 
& GetNodeType (objJNode.NodeType) & ": <b>" & objNode.Name 


'if it is an XML Declaration node, display the 'special'" 
properties 
If objNode.NodeType = XMLNodeType.XmlDeclaration Then 

'cast the XMLNode object to an XmlDeclaration object 
Dim objXMLDec =CType (objJNode, XmlDeclaration) 
Er NOES = SiLNOCSOS & UCAOCNOSOE, VELISLORO & 


objXMLDec.Version _ 
& "</b>&anbsp; standalone=<b>" & objXMLDec.Standalone & 


DE E 
Else 
'just display the generic 'value' property 
strNodes = strNodes & "</b>&nbsp; value=<b>" & objNode.Value < 
EM E 
e U 


'if it is an Element node, iterate through the Attributes 

EON LECE LOM GIS aAVANS AnNEOEMaA EN OM AaSSUE each alr OUEe 

If objNode.NodeType = XMLNodeType.Element Then 
'IiSplay THe allribulLe Informaliohn TOE each alirIbute 
Eo Each OBI ALLT TN SCIONS. ATTEIOULES 

strNodes = strNodes & GetIndent (intlevel + 1) 


& GetNodeType (objJAttr.NodeType) & ": <b>" & 


OO ALE. MME _| 


"</b>&nbsp; value=<b>" & objAttr.Value & "</b><br 
ا‎ 


Next 


End 


'if this node has child nodes, call the same function recursively 
display Ehe information fof IIE and each GE lts Child node 
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If objNode.HasChildNodes Then 
strNodes = strNodes & GetChildNodes (objJNode.childNodes, intLevel 


End 


'go to next node 


urn strNodes 'pass the result back to the caller 


UIE lk 1O 


Function GetIndent (intlLevel As Integer) 

'returns a string of non-breaking spaces used to indent each 
DIM SIrIndent AS SIrfing Wh 

Dim intIndent As Integer 

For intIndent = 0 To intLevel 

trIndent SEEIRGERNE € TEnNOSP; CASS; SAS 


urn strIndeni 
MEL UNCLE LOM 


Function GetNodeType (intType As Integer) As String 
"returns the node type as a string 
Select Case (intType) 
Case 0: Return "NONE" 
Ca Sê Return "ELEMENT" 
Case Re EUER ANTE N SUM E 
CEASE NE EMER VUES 


Case REE UE LC ODANA SE 
REE UKM WINNIE IESG 
REE IER ENE 
Re E USER EROCESS 
REE UE TT COMMENE 
REE WER DOCUMENT 
Re UE DOCUMENT OSB 
Return "DOCUMENT FRAGMENT" 
Rel UEN NOLA TONLE 
Return "WHITESPACE" 
Return GNIFICANT WH 
Return HEND ELEMENT" 
Case Return END BME TIC 
Case Return "XML DECLARATI 
Case 18: Return "NODE (ALL)" 
GaSe HISeS REE UE UNENONNL 
Bo. SEIECE 
MINE UME E LOM 


Case 
Case 
Case 
Case 
Case 
Case 
Case 
Case 
Case 
Case 
Case 


RO O SI ON UONSESE ORES 


SOV OBE GONE OS 


T1 I GT oT GI GT OT O Ci 


I SEE NOIE, 
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</body> 
cl 


سنستخدم في المثال التالي الغرض 1٥د,‏ 1(0" × مع الغرض ١0هع2۷1‏ ط۴× لن نستخدم هنا الغرض ءN0d‏ ]۷× وسنعید 
تفس المثال اأسابق: 


Page Language="VB" %> 
Import Namespace="System.Xml" %> 
Import Namespace="System.Xml.Xpath" %> 


<IDOCTYPE HIL PUBLIC T-NCIIDTD HIME 24.0 TranNsIlLIoONnal EN. 
<html><head> 
<title>Accessing XML documents using an XPathNavigator</title> 
I= HIMNEILUCS ELIS. CNOLOELNSEVLE. IME ==> 

</head> 
<body DOCOlOE TILT 

<span class="heading">Accessing XML documents using an 
XPathNavigator</span><hr /> 


<O AES OU E DOCURLY FUMIE VOLE OAV 
div AA OMEHEEOEL UNAS See > CROSS, CAA 
E MO HOME RES IE SE E URAL SEBE El > GIS 


<script language="vb" runat="server"> 
Sub Page Load() 


"CTE PIVSICAI pall TO BDockKIIST.MI Sanple TI (MR Game Toller ac 

AEM OCS 
DIM SLLCULTENLEALN AS Slr OC = RECUESL o EAVS ICAL EAL 
Dim SE MLEaE N AS GELIRNS Ue E(SERCUEEEREEAE RM, 

LASER (SL CUETO PACA, ANUJ) & UOOOELLSE o 


'create a new XmlDocument object 
Dim objJXMLDoOoc As New XmlDocument 


E 


'load the XML file 
objXMLDOoC. Load (strXMLPath) 
OUI DOCURL . 1RAE RML = Lode EIlCES <O & EC OMLEAELS & < 


Caltech ObBFErEorE As ErcebLion 
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ere ANS @ SEEING Eha 1S glace d AM Eê CAW A0 We 


'display error details 


Error.innerHTML = "<þ>* Error while accessing document</b>.<br 


& oOobjJError.Message & "<br />" & objJError. Source 
SO 1 and SEO eExeCUEON 


MiG ME 


'now ready to parse the XML document 
'itl must be well-formed to have loaded without error 
thNavigator object using the XMLDocument object 


'create a new XPail 


Dim objXPNav As XPathNavigator = objJXMLDoc.CreateNavigator () 


"move the current position to the root #document node 
objXPNav.MoveToRoOot () 


RUNE ELON EO iterate EMEOUIN all EMe MOdeS 1 Ee 


T"ECALL 4 ESCUECSLTE 


'XPathNavigator, 
outResults.innerHTML = GetXMLDocFragment (objXPNav, 0) 


O SO 


Function GetXMLDocFragment (objJXPNav As XPathNavigator, intlevel As 


Integer) As String 


Dim SIrNOGdeS AS SIFING = 
Dim intloop As Integer 


EON SOLAY IOIOEMEILION AOU LALS MOOS 

SEENOGMES = SETNOMES & CECINdEntE (INELEVEL) | 
& GetNodeType (objXPNav.NodeType) & ": <b>" & objJXPNav.Name 
& "</b>&nbsp; value=<b>" & objXPNav.Value & "</b><br />" 


'see if this node has any Attributes 


If objXPNav.HasAttributes Then 


'move to the first attribute 
objXPNav.MoveToFirstAttribute () 


Do 


O SPLayY EME MAMEOEMaAEN ON AOOME ME 
SE ENOGES = SELNOCSS & CELINOONE (IRLCLEVEN F 1) | 
& GetNodeType (objXPNav.NodeType) & ": <b>" & 


COoOJAXENAT. MEME _ 
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& "</b>&anbsp; value=<b>" & objXPNav.Value & "</b><br 


Loop While objJXPNav.MoveToNextAttribute () 


"then move back to the parent node (i.e. the element itsel! 
objXPNav.MoveToParent () 


ERE 


'see if this node has any child nodes 
If objXPNav.HasChildren Then 


'move to the first child node of the current node 
objXPNav.MoveToFirstChild () 


Do 
mec UrS ively Call CRIS CUNE EON EO display Ee CMA MOA 


fragment 
strNodes = strNodes & GetXMLDocFragment (objXPNav, intLevel + 1) 
Loop While objXPNav.MoveToNext () 


'move back to the parent node - the node we started from when we 
moved CoO ThE TITEL ChIIGAd Mode <> CUI have UCC EUS ANG FEB 


instead 
objXPNav.MoveToParent () 


End 


'must repeat the process for the remaining sibling nodes (i.e.nodes 
'at the same 'level' as the current node within the XML document 
'so repeat while we can move to the next sibling node 


Do While objXPNav.MoveToNext () 


me CUES vel Call ERAS EUNCENON EO CiSpLAN ERNLS SIONS MOE 
"and 1ES aLCTIDULES and CHILI nodes 
strNodes = strNodes & GetXMLDocFragment (objXPNav, intLlLevel) 


Loop 


Return strNodes 'pass the result back to the caller 


HAGA EUG EN OM 
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Function GetIndent (intLlLevel As Integer) 
'returns a string of non-breaking spaces used to indent each 
Dim SIFIndent AS SEIN, 
Dim intIndent As Integer 
For intIndent = To intLevel 
trIndent SEETAGENE & VEnOSP; CASS; CNS 


MN FF @F @ 


UE SE URGE 
MEA EUG NOM 


Function GetNodeType (intType As Integer) As String 
'returns the node type as a string 
Select Case 


(intType) 
Case U: REetUZN NONE 
Case REE UE ELEMENT 
Case Rel UE LATIN 

Case ROEL ULM WT 


Case MEE UE LECEDATA SE 
Case RetUEnD LENTIL 
Case ROE UE ONTO 
Case MEE UE LEROCESS 
Case Return "COMMENT" 
Case Rel UE "DOCUMENT 
Case et UE DOCUMENT ESET 
Case Return "DOCUMENT FRAGMENT" 
Case Ret UE NOLAT TONY 
Case REE UE WHTLRESEAGCE 
Case Return GNIFICANT WH 
Case Return END EUEMENTT 
Case Return END BNET 
Case Return "XML DECLARAT'I 
Case 18: Return "NODE (ALL)" 
Case ElSe: ReLUrEN LUNKNOWN 
MONO SELECE 
El UIE E 1O 


O OO SN O NIS GOSS 


Cen CSL > Om CS 


ERG GC FC O CT Cl CT 


CY SEES 


</body> 
VM EMNE 


سنقوم بعمل مشابه للأمثلة السابقة هذه المرة باستخدام الغرض ١ء‏ ل2 .×1١11 ٠×۸‏ 


<%$@GPage Language="VB" %> 
<$S@Import Namespace="System.XML" %> 


€ I DOC SE ATM SUSLLE = /MOCI/DLD HINL 4.0 Transit tonal 1/01 
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<html><head> 

<title>Accessing an XML document with an XMLTextReader object</title> 
l= HINCILUOS ELLIS. NOLOSEAINSEYLE. ARCS > 

</head> 
BOY OICOLO E E 

<span class="heading">Accessing an XML document with an XMLTextReader 
object</span><hr /> 


GE MEO DOCURLY TUNIC SCUOLA 
Ey E OMIEMETEO ll UMA See E > CMOS CAS 
iy ALOU EReESTUN ESL BUNA E= Se Rye R> COE 


<script language="vb" runat="server"> 


Sub Page Load() 


"create PiySIcCal path To booklist. Sample TIlê (RN same Tolder as 
ES Page 
DIM SEE UREERNEEAEN AS SEID 2  MeGUESE. ERVSI CALEAER 
DIM SEEXMLUEAEN AS SEEINS Ue E(SELCUEEENEEAE RM, 
INSEL EREV (SL ECUETONL PACA, AND) & UOOOELISE ML 


'declare a variable to hold an XmlTextReader object 
Dim objJXMLReader As XmlTextReader 


TE 


'create a new XmlTextReader object for the XML file 
objJXMLReader = New XmlTextReader (strXMLPath) 
outDocURL.innerHTML = "Opened file: <b>" & strXMLPath & "</b>" 


CalLCEh OBDIETIGE AS EcESLION 


'display error details 
iE EKE HOE. ARREEE AL LO ETO MAE ACCESS ANS COCUMENEC/ O. OF 


& objJError.Message & "<br />" & objError. Source 
Sub ' and stop execution 


MEL E 


"now ready to read (or "pull") the nodes of the XML document 
Dim strNodeResult As String = '"" 
Dim objNodeType As XmlNodeType 
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'read each node in turn = returns False 1f no more nodes to read 
Do While objJXMLReader . Read () 


'select on the type of the node (these are only some of 


types) 
objNodeType = objXMLReader. NodeType 


Select Case objNodeType 


Case XmlNodeType.XmlDeclaration: 
'get the name and value 
strNodeResult += "XML Declaration: <b>" & objJXMLReader . Name 


& " '" & objXMLReader.Value & "</b><br />" 


Case XmlNodeType.Element: 
'just get the name, any value will be in next (#text) node 
strNodeResult += "Element: <b>" & objJXMLReader.Name & 
EMS AE ll 


Case XmlNodeType. Text: 
"just display the value, node name is "#text" in this case 
strNodeResult += "&nbsp; - Value: <b>" & objXMLReader. Value 


2 Ue IOI E 


MNO SEIS 


'see if this node has any attributes 
If objXMLReader.AttributeCount > 0 Then 


"iterate through the attributes by moving to the next one 
'could use MoveToFirstAttribute but MoveToNextAttribute does 
'the same when the current node is an element-type node 

Do While objXMLReader.MoveToNextAttribute () 


'get the attribute name and value 
strNodeResult += "&nbsp; - Attribute: <b>" & 
objJXMLReader.Name _ 
E LOS CMDS; Value: > C&C 


objXMLReader.Value _ 


6 OS DIE SL 
Loop 


End 


Loop "and read the next node 


Universal Knowledge Solutions s.a.1. 
169 


"finished with the reader so close it 


objXMLReader. Close () 


'and display the results in the page 


s.innerHTML = strNodeResult 


outResult 


NEL SUS 


VISE EOI 


</body> 
N 


في المثال التالي سنقوم باستخدام الغرض ١×W 16١‏ ۷1× و سنقوم بكتابة وثيقة 11× بواسطته. نلاحظ أننا بدأنا بإنشاء الغرض 
Xm" e>tW ۲‏ ثم قمنا بتحديد التنسيق (مقدار الإزاحة بين العناصر) من ثم بدأنا بكتابة الوثيقة باستخدام طرق الغرض مثل 


....WriteStartElement sg WriteComment sg WriteStartDocument 
.Cامو# ثم قمنا بتفريغ محتوى الغرض إلى الملف و أغلقنا الملف باستخدام الطريقتين طكنا؟ و‎ 


بعدها قمنا بفتح الملف و تحميل محتواه إلى سلسة محارف ثم قمنا بكتابة المحتوى إلى عنصر التحكم من جهة المخدم tاuاوءRإ0u.‏ 


uage="VB" $%> 
mespace="Ssystem.XML" %> 


Import Namespace="System. IO" %> 


ML SUSBLLGE U IMICLIDID MIME 4.0 TEEN EAOmA I7 NES 


ing an XML document with an XMLTextWriter object</title> 


Hadê and 
TMOOE E Ma 


DOCH EE ET 
<html><head> 
<title>Creat 


l= FINE UCE CALE. cc OLOOALNE EVILS, IMC => 


1a EF MS 
"heading">Creating an XML document with an XMLTextWriter 
E 


DOCU Uma lse Ele RL € 
Error" runat="server">&nbsp;</div> 
Res MU ESL SURA E = Se e >c AE 


uage="vb" runat="server"> 


d() 
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</head> 

OOO OOEOLO 
ا ا‎ 
object</span 


<div id="oul 
<div id="oul 
<div id="ou'! 


SCTE ang 


SU AGE HOA 


folder as ASPX page) 


Lh for the new file (in same 
EC BRVSI ECA EA E 


EAC EEE RE EAE RN AS SE INI Request 
Dim SETXNLEAEMN AS SEEINS Ue E (SELOULEENEEAER, 
TDS EERE (SE FOUEEEREEAER, CT) ) CE mMeuWBOOKII SE XML 


'create physical pa 


Dim si 


'declare a variable to hold an XmlTextWriter object 
Dim objJXMLWriter As XmlTextWriter 


UE 


'create a new objXMIWriter object for the XML file 


= New XmlTextWriter (strXMLPath, Nothing) 
Ele: C> CG GCEEXMUESEM & 


objJXMLWriter = 
OWE DOCURLS AME CL = rill LO i 


E O 


Exception 


BERO AS 


CEE OS 


'display error details 
Error while accessing document</b>.<br 


ME EOE ¢ A RRE ML, = <o | 


HERF OE. SOUEE € 


SS OB EEEFOE Mes Sage C&C <O >l © Oogl 
E SUS ' and SEOP exeCUEIOn 


IDOE TE 


for the new XML document 


'nOWN EEeady Lo wWIEITe (Oof "push") lhe nodes 


Eun OM indented EOEMaAEEINS ana Sel imdentét EO 3 CMSAEAECEEe ES 
objJXMLWriter.Formatting = Formatting. Indented 
= 3 


objJXMLWriter. Indentation 


'start the document with the XML declaration tag 
objJXMLWriter.WriteStartDocument () 


'write a comment element including the current date/time 
objJXMLWriter.WriteComment ("Created using an XMLTextWriter - " & 


Now () ) 
BookList> root element 


'write the opening tag for the <l 
objJXMLWriter.WriteStartElement ("Booklist") 


Book> element 


FOE 2 <] 


'write the opening tag 
objJXMLWriter.WriteStartElement ("Book") 


'add two attributes to this element's opening tag 
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objXMLWriter.WriteAttributeString ("Category", "Technology") 
Dim intPageCount As Integer = 1248 'numeric value to convert 
objXMLWriter.WriteAttributeString ("Pagecount", 

intPageCount. ToString ("G") ) 


'write four elements, using different source data types 

objJXMLWriter.WriteElementString ("Title", "Professional Video 
Recorder Programming") 

Dim datReleaseDate As DateTime = #03/03/2000# 

objXMLWriter.WriteElementString ("ReleaseDate", 
datReleaseDate.ToString ("yyyy-MM-dd") ) 

Dim intSales As Integer = 17492 

objJXMLWriter.WriteElementString ("Sales", 
intSales.ToString ("G")) 

Dim blnHardback As Boolean = True 

objJXMLWriter.WriteElementString ("Hardback", 
blnHardback.ToString () ) 


'write the opening tag for the <AuthorLlList> child element 
objXMLWriter.WriteStartElement ("AuthorList") 


'add two <Author> elements 
objJXMLWriter.WriteElementString ("Author", "Francesca Unix") 
objJXMLWriter.WriteElementString ("Author", "William Soft") 


'close the <AuthorLlList> element 
objJXMLIWriter.WriteEndElement () 


"Close EME CEOOK > eleMeRE 
objJXMLWriter.WriteEndElement () 


'close the root <BookList> element 
objJXMLWriter.WriteEndElement () 


"flush the current content to the file and close it 
objJXMLWriter. Flush () 
objJXMLWriter. Close () 


'now open the new XML file and read it into a string 
DIM SETIMITESUITE AS SUTING 

Dim objJSR As StreamReader = File.OpenText (strXMLPath) 
strXMLResult = objJSR.ReadToEnd() 

oObjJSR.Close 

OO SK = NOE ME 


"and display the results in the pagê 
outResults.innerHTML = "<pre>" & Server.HtmlEncode (strXMLResult) & 
r <pre>" 
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الفصل الثاني عشر 
استخدام ۸3۸ 


يتعرف الدارس في هذا الفصل على: 
لماذ| AJAX‏ 
حسنات و سیئات AJ۸×‏ 
ادوات تطویر ×۸3۸ 
التحديث الجزئي في ×۸3۸ 


AJAX 


تعلمنا في الجلسات الماضية كيفية بناء صفحات وب تستخدم نموذج )عهطاوoم.‏ 

يتم في هذا النموذج إعادة إرسال الصفحات بشكل مستمر إلى المخدم لتتم إعادة توليدها. 

فإذا أخذنا مثلا مثال بطاقة التهنئة الذي عملنا عليه في جلسة سابقةء ستتم إعادة إرسال الصفحة في كل مرة يختار فيها المستخدم نوع 
خط أو لون أو يدخل نصا ما. 

يستدعي هذا من ۸8۴.٤‏ إعادة تصيير الصفحات مراراً وتكراراً وإعادة استلام المتصفح لنسخة جديدة من الصفحة. 


يتطلب هذا السيناريو عملا كثيرأ وإن كان الزمن اللازم لإعادة توليد الصفحة مقبولاً نسبياً لكن هناك وقت ضائع في إعادة توليد 
وإرسال واستقبال الأجزاء التي لم تتغير من الصفحة. 

كما تعد عملية إعادة الإرسال مشتتة بعض الشيء للمستخدم الذي قد تتم مقاطعته أثناء إدخاله للمعلومات ضمن عنصر تحكم آخر أو 
زلق الصفحة إلى بدايتها. 


لذلك ستفتقر تجربة استخدام التطبيق الناتجة إلى التجاوب الذي تمنحه تطبيقات سطح المكتب. 

ظهر مؤخرا جيل جديد من تطبيقات الوب التي تؤمن للمستخدم تفاعلاً شبيهاً بذلك الذي يمكن الحصول عليه في تطبيقات سطح المكتب. 
تحدث هذه التطبيقات نفسها بشكل سريع وتقدم ميزات خاصة مثل الحركة وقابلية الجر والإلقاء. 

من الأمتلة الشائعة على هذه التطبيقات البريد الالكتروني الذي توفره ماعمم والأدوات متل Nps‏ ماعممق. 

يستخدم هذا الجيل الجديد من تطبيقات الوب ممارسات في التصميم وتقنيات تعرف باسم ×۸[۸. 

×4[ اختصار لمجموعة من التقنيات التي تساعد على إنشاء صفحات ديناميكية أكثر تجاويا. 

تعتبر القدرة على تحديث جزء من الصفحة دون التأثير على الأجزاء الأخرى أحد الدعامات الأساسية في ×۸[۸. 


كيف نفهم ×۸3۸ - الحسنات 
لتشكيل فهم واضح لتقنية ×۸[۸ لا بد من البدء بتحديد حسنات وسيئات هذه المقاربة: 


الحسنات : 
٠‏ تعتبر الفائدة الأساسية لتقنية ×۸[۸ هي الاستجابة. 
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نحصل عند تصميم تطبيق ×۸[۸ بشكل صحيح على تجربة أفضل من وجهة نظر المستخدم. 
وإن كان المستخدم لا يستطيع أن يحصل على أي جديد أو على سرعة أكبر لكن تظهر تجربة الاستخدام بشكل أكثر نضوجا 
وتكلفاً وبالأخص إذا كان التطبيق الذي نقوم بتطويره ينافس تطبيقات أخرى ممائلة لا تستخدم هذه التقنية. 
توفر ×۸[4 إضافة إلى هذا ميزات غير ممكنة في صفحات الوب التقليدية. على سبيل المثال تستخدم ×۸[۸ بشكل كبير 
رماز ا۷45[ الذي سيستجيب للأحداث من طرف الزبون مثل حركة مؤشر الفأرة وضغط الأزرار. 
حيث تعتبر هذه الأحداث عالية التكرارية مما يجعل من غير العملي التعامل معها باستخدام نموذج )عهطااو0م. 
مثلاً في حال أردنا تمييز علبة نصية عندما يتحرك مؤشر الفأرة فوقها سنحتاج في حال اخترنا نموذج kعهطاومم‏ إلى إعادة 
إرسال كامل الصفحة إلى مخد الوب إغادة توليدها وتحديك الصفحة ضمن المشعرض في الوقت الذي قد يكون فيه مزشز 
الفأرة قد تحرك إلى مكان ثان كليا. 
تستطيع ×۸[ الاستجابة مثل هذا اللسيتاريو والتجاوب بشكل آثي» قرت الأصفحة عد الحاجة وطلب أي معلومات من 
مخدم الوب في الخلفية عند الحاجة إليها. 
يملك المستخدم الحرية في استمرار التعامل مع الصفحة خلال فترة إرسال الطلب إلى المخدم حتى أنه لن يشعر بإرسال 
الطلب أصلاً. 
ملاحظة: ليست ×۸[4 في الحقيقة تقنية جديدة ولكنها مجموعة من الممارسات التي تسمح باستثمار ام ذإه8ة4۷[ وغرض 
HttpRequest-ا XM‏ الذي توفره بعض المستعرضات. 


كيف نفهم ×۸3۸ - السيئات 


السيئات : 
يشمل استخدام ×۸[۸ تحديين أساسيين الأول مرتبط بالتعقيد حيث تعتبر عملية كتابة نص م1٥28[‏ البرمجي في تطبیق ×۸ ۸3 
لحسن الحظ ستقوم ۸8۴.٤1‏ بإدارة هذا الموضوع عوضا عن المطور إذ توفر مجموعة من الميزات التي تسهل التعامل مع 
.AJAX‏ 
يكمن التحدي الثاني في مدى دعم المستعرض ل×۸[۸. 
ظهرت التقنية التي تدعم ×۸[۸ منذ عدة أعوام ولكنه لم يتم دعمها بشكل كامل على معظم المستعرضات حتى وقت قريب. 
إذا قمنا بالتفاعل مع تطبيق ×4[ باستخدام مستعرض 15 يجب التأكد من كون النسخة أحدث من النسخة 5 كذلك هي الحال بالنسبة 
للمستعرضات الأخرى كما يوضح الجدول التالي: 

المستعرض النسخة 
Internet Explorer‏ 5 
Netscape‏ 7 
Opera‏ 7.6 
Safari‏ 1.2 
FireFox‏ 1.0 
يتعلق قرار استخدام ×۸[4 بمستخدمي التطبيق لكن يمكن الجزم بأن ×۸[۸ ستعمل بشكل طبيعي على %90 من مستعرضات 
الزبائن. 
ولكن هل معنى هذا أن مستخدمي المستعرضات القديمة لن يتمكنوا من استخدام التطبيق؟ 
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ثرتبط الإجابة بالميزة المستخدمة ففي حال استخدام ميزة التصيير الجزئي التي توفر ها ۸8۶.۴1 من خلال عنصر تحكم 

1 tلJp‏ مثلاً ستعمل الصفحة بشكل طبيعي حتى على المستعرضات التي لا تدعم ×4 [4 حيث سيتم استخدام إعادة الإرسال 
الكلية عوضاً عن التحديث الجزئي. 

أما في حال استخدام عناصر تحكم ×4[ أكثر تعقيداً سنجد أنها لن تعمل بشكل صحيح على المستعرضات القديمة. 

يكفي للتأكد من دعم صفحات التطبيق للمستعرضات القديمة إلغاء تفعيل أمذإهSة4۷[‏ من المستعرض وإعادة تجريب الصفحات. 

لا بد أن نعلم هنا أن هناك ثمن سندفعه لقاء استخدام ميزات ×4[ ويرتفع هذا الثمن كلما تطلبت الميزة دعماً قد لا توفره معظم 
المستعرضات. 

أخيراً تقوم ×4[ بالكثير من الأعمال ضمن صفحة واحدة وهذا المقهوم قد لا يكون مرغوياً ولا ينسجم مع مايتم عادة ضمن 
صفحات الوب التقليدية. 

ملاحظة: قد تؤثر هذه المقارية على طريقة المطور في تصميم التطبيق بشكل عام. 


أدوات تطویر ×۸3۸ في ASP.NET‏ 


هناك عدة طرق لاستخدام ×۸[۸ في أي تطبیق بما فیها تطبیقات .۸8۲.×N ٤1‏ 
لتطوير تطبيقات ×۸[4 دون الحاجة إلى الأدوات التي توفرها ۸8۴.۴1 يكفي أن يمتلك المطور فهماً كافياً لام ذإ6؟ه ۷ه[ كونها 
اللغة الأساسية التي يستخدمها المستعرض ويطلب بواستطها المعلومات من مخدم الوب حسب الحاجة. 
بالرغم من كون ۲٥25هل‏ غير شديدة التعقيد لكنه يصعب كتابة برنامج صحیح بو اسطتها وذلك لسببين : 
- تختلف تفاصيل تطبيق امذإ٥5ة۷ه[‏ من مستعرض إلى آخر مما يتطلب خبرة كبيرة لدى المطور لكتابة صفحة مستقرة قادرة 
على العمل بشكل صحيح على كل المستعرضات. 
- يوؤخذ على †م1ا6؟ ههل[ أنها لغة سيئة السمعة تتغاضى عن الكثير من الأخطاء مما يجعل عملية تحديد مكان هذه الأخطاء 
وإزالتها عملية صعبة حتى أن بعض هذه الأخطاء قد يكون قاتلاً في بعض المستعرضات ويتم تجاوزه دون أي أثر في 
مستعرضات أخرى مما يعقد عملية إزالة العلل من النص البرمجي. 
سنركز في هذه الجلسة على استخدام نموذج بسوية أعلى لتطوير تطبيقات ×۸[4 وذلك بالاعتماد على ما تقدمه ۸8۲.۸۴1 من 
مكونات وعناصر تحكم من طرف المخدم خاصة بهذا الغرض . 
تقوم عناصر التحكم آلياً بتصيير نص اصذإ4۷486[ المطلوب للحصول على التأثيرات المرغوبة. 
يمكن بهذه الطريقة بناء تطبيقات ×۸[4 مع استمرار المحافظة على العمل في بيئة مألوفة وبإنتاجية عالية. 
لن نحصل باستخدام أدوات ×۸[۸ ضمن ۸8۴.٤1‏ على مرونة وقدرة كبيرة على التخصيص ولكننا سنكون قادرين على الحصول 
على تطبيقات عاملة وبأقل جهد ممكن . 


مدير النص 
لنتمکن من استخدام ×۸[۸ ضمن ۸8۴.٤1۲‏ نحتاج إلی استعمال عنصر تحکم وب جدید ھو 8٥۲11۷4۸38۴۲‏ حیٿث یعد عنصر 


التحكp la‏ لب .ASP.NET AJAX‏ 
يتوضع عنصر التحكم هذا كباقي عناصر التحكم على شريط الأدوات ضمن التبويب ×۸[۸ ويؤدي سحبه إلى الصفحة إلى إضافة 
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التأشيرة التالية: 
<asp:ScriptManager ID="ScriptManager1" runat="server"></asp:ScriptManager>‏ 
يظهر عنصر تحكم إعع2٣ة۷م1إءS‏ في زمن التصميم كعلبة فارغة فضية اللون ولكن عند استدعاء صفحة تحتوي على عنصر 
التحكم هذا لن نرى أي شيء مكانه. 
لا يقوم عنصر التحكم هذا بتوليد أي تأشيرات ا11۷ ولكن يقوم بإضافة روابط إلى مكتبات امأإه؟ه۷ه[ الخاصة ب×۸[۸ وذلك 
بإاضافة نصوص خطاطية شبيهة بالشكل التالي: 
<script src="/YourWebSite/ScriptResource.axd?d=RUSU1ml ..."‏ 


type="text/javascript"> 
</script> 


نلاحظ هنا أن النص الخطاطي استخدم الواصفة ١۲ء‏ للوصول إلى نص ام۲1٥25‏ ۷ه[ ولكن تم استخدام صيغة مسار لاتعبر في الحقيقة 
عن ات ملت كا ران بضر 48۴۸ باجا اقلت التمن قي ات 2135 الشرجمة إلى لها لتخي 
تحدد سلسلة الاستعلام المحرفية في نهاية عنوان ۸1ل لللاحقة إ×ه.٥٣إ0uءه1RمipاءS‏ ما هو الملف الذي يجب إرساله إلى 


ماتحظة لا طك المفخات الحارية على تة زا أطرل تسيا الها من المخد كرن الملقات الستكدمة مخكوطة بت 
حفظها ضمن ذاكرة الخبئ في المستعرض وأحيانا يتم نقلها بشكل مضغوط من المخدم مباشرة في حال دعم المستعرض لهذه الميزة. 


تتطلب کل صفحة ×۸[۸ استخدام مثیل لغرض Sc 214g er‏ . 
تقوم عناصر التحكم الخاصة ب ×هزة بالتفاعل مع غرض ScriptM412ager‏ لتطلب منھ تأسیںس ارتباطات إلى موارد ام11 Javasc‏ 
إضافية. 


ملاحظة في حال الحاجة إلى استخدام ميزات ×۸[۸ في معظم صفحات الموقع يمكن أن نقوم بوضع عنصر ScriptManager pa‏ 
ضمن الصفحة الأساسية (ععهم إمائج). 

قد يتسبب هذا السيناريو بمشكلة نابعة من ضرورة تغيير إعدادات خصائص غرض 8٥۲1۷3142٥١‏ لتخصيصها بكل صفحة. 

يكون الحل في هذه الحالة استخدام غرض ۷×٥إ۲۴ءع14‏ 3م۲1٥5‏ في كل صفحة مما يسمح بتحديد إعدادات مختلفة. 


مواضیع هامة 


سنقوم ضمن ما تبقى من هذه الجلسة بتغطية مجموعة من المواضيع المرتبطة ببناء صفحات ×۸[۸ وهي: 
امكف تالز تي كج اغا زهان اة 
استخدام مؤشر التقدم للتعامل مع التحديثات البطيئة. 
- استخدام التحديث وفق جدول زمني لتحديث جزء من الصفحة. 
استخدام عناصر تحکم أدوات تطویر ×۸[۸ في .ASP.N ٤1‏ 


التحديث الجزئي 


يعتبر التحديث الجزئي تقنية أساسية في تطبيقات ×۸[۸. 
في هذه المقاربة لا نحتاج إلى إعادة إرسال الصفحة وتحديثها من قبل المستعرض ولكن عند حصول شيء ما تقوم الصفحة بطلب 
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المزيد من المعلومات من المخدم. 

تتم هذه العملية في الخلفية مما يحافظ على استجابة صفحة الوب. 

يوضح الشكل التالي الفرق بين استخدام ×۸ [۸ وتحديث الصفحات بشكل تقليدي في :۸5۶۲۴.۸N ٤1‏ 
تحديث صفحة الوب بالط يقة التقيدية 


postback èaul 


Elek triggers ã 


pasihack ل‎ 


ASFNET 
Serer ru û 
hw HTML pağE 


wilh rê chan ğêš 


تحديت الصغحات باستخذام 


کرلک 


mayrichiromoms call 1 


ASFNET 
Server reli 
alta Pif išbd I 


updaile tê page 


تتضمن ۸8۴.٤1‏ عناصر تحكم مفيدة تسمح بتحويل صفحة عادية تستخدم منطقاً من جهة المخدم وتحديثها بدون رجفة في الصفحة 
باستخدام التحديث الجزئي. 
عنصر التحکم هذا ھg UpdatePanel‏ . 
الفكرة الأساسية هي تقسيم صفحة الوب إلى منطقة مستقلة أو أكثر وتغليف كل منها بعنصر تحكم 1٥«ة‏ ۴لم غير المرئي. 
عند انطلاق حدث في أحد عناصر التحكم المحتواة في عنصر تحكم 1ع ة۴ء هلما سيتم اعتراض عملية إرسال الصفحة واستبدالها 
باستدعاء غير متزامن. 
يتم العمل وفق المراحل التالية: 

1- يقوم المستخدم بنقر الزر ضمن عنصر تحکم dat e۴2 1٤1‏ م .U‏ 

2- يقوم عنصر التحكم ۵٣٥1‏ ۴ءه لمل باعتراض حدث النقر واستبداله بطلب غير متزامن. 

3 يتم تنفيذ دورة حياة الصفحة الطبيعية من طرف المخدم وتصيير الناتج كنص ۳1۷1 وإعادته إلى المستعرض. 

- تستقبل ×۸[۸ ۸8۶.N٤1‏ كامل صفحة 1۲۷1 وتقوم باستبدال محتوى عنصر التحكم بالمحتوى الجديد. 


لن يتم تعديل أي شيء غير محتوی ضمن عنصر تحکم .U pd ate ٣4٤1‏ 
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مثال على اwتخدlم UpdatePanel‏ 


يستخدم المثال التالي عنصر تحكم ”٤1‏ ۴۵هل م0 لتحديث الزمن الحالي دون إعادة إرسال كامل الصفحة أو التأثير على المكونات 


Uriel E Windums Temel, Explor et‏ ن 


11:32:15 PM 


Refresh Time 


Cf @ Iiemet | Protected Made: On 


نلاحظ أنه لا بد من استخدام عنصر تحكم إ6عM1212م1إءS‏ قبل عنصر تحكم 1ع” ة۴ ةمل لأن الصفحة تحتاج إلى الحصول على 
نصوص ام1إءءه۷ه[ قبل أن تستطيع استخدامها. 


الثمن الذي سندفعه لقاء هذه الميزة هو بعض الوقت الإضافي اللازم للعملية 
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أحد نقاط الضعف في هذه المقاربة والتي تجعلها مختلفة عن عملية بناء نص ۷456هل يدوياً هي الاضطرار إلى تحميل كامل 
الصفحة وإن كان القسم الذي سيتم الاستفادة منه يقتصر على الزمن والتاريخ الحالي. 


معالجة الأخطاء 


ذكرنا سابقاً أن عنصر التحكم اع٣‏ ۴اه لملا لا يؤّثر على الآلية التي يتم فيها العمل على المخدم وأن الفارق يقتصر على آلية 
الاتصال حيث تتم العملية باستخدام استدعاء غير متزامن. 

عند حدوث استثناء غير معالج يتم التقاط الخطاً من قبل غرض 4٠296۲‏ 1م١٣٥5‏ وتمريره إلى الزبون. 

يقوم نص ٥۷28هل‏ من جهة الزبون بتوليد خطاً امأ avaSCل.‏ 

ما يحدث لأحقاً منوط بالمستعرض المستخدم ولكن عادة ما تتجاوز معظم المستعرضات الأخطاء بشكل صامت. تظهر في 1٤‏ مقلا 
رسالة ضمن شريط الحالة تحدد المشكلة. 

هناك خيارات أخرى للتعامل مع الأخطاء التي تظهر عند استخدام استدعاء غير متزامن من هذه الطرق استخدام صفحات الأخطاء 
المخضصة: 

كل ما نحتاجه للتعامل مع هذه الصفحات إضافة العنصر "٤ ۲۲٥۲۶<‏ 0اءاء> إلى الملف وأ؟ئصمع. اهس بصيغة مشابهة لما يلي: 


عند تلقي Pag eRequestManager‏ خطا سيقوم بإعادة توجيه المستعرض إلى الصفحة ×م5ھ.98 ۲۴١۲۴۵‏ وإضافة معامل 
athمrrorpهx×مءه‏ إلى السلسلة المحرفية للاستعلام ضمن محدد ا۸ل للصفحة التي سببت المشكلة. 


يمكن كتابة نص برمجى ضمن الصفحة ×ط5ه.٥ع 8۲۲٥۲۴۵‏ يقوم بقراءة معلومات المعامل 1٤۵م۲٥۲۲ء×مءه‏ كما فى المثال التالى: 
ي 8 2 P Ip‏ هي ي 
trin xe rpatl "1‏ 


ملاحظة: عند استخدام صفحات الأخطاء المخصصة لا بد من إسناد القيمة ١ء1‏ إلى الخاصة 
.ScriptManagerAllowCustomErrorsRedirect‏ 

ملاحظة: تتضمن ۸5۶۴.N٤13.5‏ عنصري تحکم لا يمكن استخدامها مع 1٥٣۴2ءat‏ لم0 وهي عنصر تحکم FileInput‏ 
.HtmlInputFile s‏ 


التحديث الشرطي 


قد تحتوي صفحات الوب المعقدة على أكثر من عنصر تحكم ۴a e1‏ eعdatمU.‏ 

في هذه الحالة عند إطلاق أحد هذه العناصر لعملية التحديث سيتم تحديث جميع مناطق عناصر التحكم تلك. 

لتلافي عملية تحديث جميع عناصر تحكم 1ء ة۴ءاهل مل نلجأ إلى إسناد القيمة 0٣21‏ نله إلى الخاصة ءالما لعناصر 
التحكم عو ا عن القيمة ysجےس!آ۸.‏ 

ستقوم عناصر 11٤1‏ 18۴هل م بتحديث نفسها فقط إذا تم إطلاق الحدث من أحد عناصر التحكم التي تحويها. 

ملاحظة:عند استخدام هذه الطريقة سيتم تحديث جميع قيم عناصر التحكم ضمن جميع عناصر 1ء٣٣۴‏ عاه لمل لكن لن يظهر هذا 
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التغيير إلا ضمن عنصر 1٥١ة۴ء‏ اهل مل الذي أطلق الحدث (من خلال أحد عناصر التحكم المحتواة ضمنه). 

تتضمن هذه المقاربة مشكلة تظهر عندما تستلزم أحد التحديثات وقت طويل مما يتيح المجال لمقاطعته بتحديث آخر. 

كما نعلم تستخدم ۸8۴.٤1‏ إعادة الإرسال غير المتزامن في ×4[ والذي يتيح عملية إرسال حتى في حال كون عملية الإرسال 
السابقة لم تنتهي بعد. 

في حال حصول عملية تحديث متزامنة على نفس العنصر ستقوم ۸8۴.٤1‏ بمقاطعتها للمحافظة على استقرار و تجانس معلومات 
الجلسةء الكعكات وبيانات حالة التطبيق بشكل عام. 

لذلك عند إعادة الإرسال غير المتزامن تقوم ۸8۴.٤٣‏ بإهمال الطلب القديم وهنا قد تتولد المشكلة. 

عند الرغبة في منع مقاطعة عملية إعادة إرسال غير متزامنة يمكننا إضافة رماز أمأ٥5ه۷ه[‏ لإلغاء تفعيل عناصر التحكم في الفقرة 
التي سيكون فيها الطلب قيد الإرسال. 

یمکن أيضاً أن یستخدم عنصر تحکم ۲٥٤8‏ ع )هل مل والذي سیتم تناوله لاحقاً ضمن هذه الجلسة لهذا الغرض. 


القادحات 


استخدمت الأمثلة التي قمنا باستعراضها في هذه الجلسة السلوك المبيّت في عنصر تحكم 1ع ٥‏ ملم ل. 

ماذا لو أردنا الحصول على تفاعل أكثر تعقيداء سنضطر إلى المزيد من التحكم بتحديث عناصر ٣٤1‏ ۴لم عبر الرماز باستخدام 
القادحات. 

سنقوم في هذا الجزء من الجلسة بإعادة العمل على متال بطاقة التهنئة الالكترونية الذي يقوم بالتحكم بشكل إظهار وتفاصيل البطاقة. 
إن أهم ما يميز هذه المقاربة عن سابقتها هي الحصول على نفس النتيجة باستجابة أعلى. 

يتم في هذا المثال استخدام عنصر تحكم ٣2,٥1‏ ء هلم للحصول على الاستجابة المطلوبة. 

الطريقة الأسهل للوصول إلى هذا هي إضافة عنصر تحكم S٥۲11۷36‏ ثم وضع كامل الصفحة ضمن عنصر تحكم 
Up datePْ1‏ واحد كما يوضح الرماز التالي: 


<asp:Script Manager ID="ScriptManager1" runat="server'"></asp:ScriptManager> 
<asp: UpdatePanel ID="UpdatePanel1" runat="server'""> 
<ContentTemplate> 

<!-- These are the controls for creating the greeting card. --> 
<div style="..."> 

Choose a background color:<br /> 

<asp:DropDownList id="IstBackColor" runat="server" 
Width="194px" AutoPostBack="True"> 
</asp:DropDownList> 

<br /><br /> 

Choose a foreground (text) color:<br /> 
<asp:DropDownList id="lIstForeColor" runat="server" 
Height="22px" Width="194px" AutoPostBack="True" > 
<l/lasp:DropDownList> 

<br /><br /> 

Choose a font name:<br /> 

<asp:DropDownList id="IstFontName" runat="server" 
Height="22px" Width="194px" AutoPostBack="True"> 
<lasp:DropDownList> 

<br /><br /> 

Specify a font size:<br /> 

<asp:TextBox id="txtFontSize" runat="server" 
AutoPostBack="True"> 

</asp:TextBox> 

<br /><br /> 

Choose a border style:<br /> 
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<asp:RadioButtonList id="lstBorder" runat="server" 
Height="59px" Width="177px" Font-Size="X-Small" 
AutoPostBack=" True" RepeatColumns="2"> 
</asp:RadioButtonList> 

<br /><br /> 

<asp:CheckBox id="chkPicture" runat="server" 
Text="Add the Default Picture" AutoPostBack="True"> 
<lasp:CheckBox> 

<br /><br /> 

Enter the greeting text below:<br /> 

<asp:TextBox id="txtGreeting" runat="server" 
Height="85px" Width="240px" TextMode="MultiLine" 
AutoPostBack=" True"> 

</asp:TextBox> 

</div> 

<!-- This is the panel that shows the greeting card. --> 
<asp:Panel ID="pnlCard" runat="server" ... > 

<asp:Label id="lblGreeting" runat="server" Width="27 2px" 
Height="150px"></asp:Label> 

<br /> 

<asp:lmage id="imgDefault" runat="server" Width="21 2px" Height="1 60px" 
Visible="False"></asp:lmage> 

</asp:Panel> 

</ContentTemplate> 

</asp: UpdatePanel> 

The greeting card is then generated when the Page.Load event fires: 
protected void Page_Load(object sender, EventArgs e) 


{ 
if (!this.IsPostBack) 


/l (Initialize all the controls here.) 


} 


else 


// Refresh the greeting card. 
UpdateCard(0; 


} 


يقوم عنصر التحكم ۴21٤1‏ ءلمل بمر اقبة عناصر التحكم المحتواة ومقاطعة أي طلب يمكن أن يتسبب بإعادة إرسال الصفحة. 
يمكن أن يطلق طلب إعادة الإرسال من نقر زر أو كما في مثالنا من أحدlث TextBox. TextChanged‏ 

.ListBox.SelectedItemChanged s 

عند تعديل الإعدادات في الجزء الأيسر سيتم تعديل الشكل في القسم الأيمن دون حدوث إعادة إرسال. 

في حال إجراء أكثر من تعديل بتتالي سريع سيتم استخدام النتيجة الأخيرة المعادة و الشاملة لجميع التغييرات الحاصلة. 
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مع أن هذا المثال يؤدي الهدف المطلوب إلا أنه يقوم بأعمال أكثر من اللازم لاتمام هذا الهدف. 

تم في هذه المقاربة وضع كامل الصفحة في عنصر تحكم 1٥١۴ء‏ ةلم واحد أي سيتم تحديث نص ا1۲۷ لكامل الصفحة في كل 
في هذه الحالة يتمثل الخيار الأفضل بتضمين عناصر البطاقة فقط ضمن عنصر 1عمة۴عاةلمل. 

لن تعمل هذه المقاربة بالشكل الصحيح لأنه لن تتم عملية اعتراض أي من الأحداث التي تنتجها عناصر التحكم الغير محتواة في 

Ute 1‏ و ستتسبب في إعادة إرسال كامل الصفحة. 

يكمن الحل في تكليف عنصر 1٥۴1هل‏ مل بشكل صريح بمراقبة الأحداث التي تصدرها عناصر تحكم معينة حتى ولو لم تكن 
محتو اة ضمن عنصر ٥21٤1‏ ء )ھل مل ھذا۔ 

تتم هذه العملية باضافة قادحات إلى عنصر التحكم ۴1٥1‏ ءعtولم0.‏ 

يمكن إضافة قادح واحد لكل زر كما يبين الرماز التالي: 
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تقوم القادحات بإبلاغ عنصر ٣8|‏ ۴4 هة لمل بمقاطعة الحدث التلقائي لعناصر التحكم تلك. 


يمكن استخدام القادحات بطريقة أخرى غير مراقبة بعض عناصر التحكم يمكن أيضاً استخدامها لإهمال الطلبات غير المتزامنة واستخدام طلب إعادة 
إرسالكامل الضفحة غوضا عنة. 
نستخدم لهذا الغرض القادح إءعٍع!١‏ )ء4 8ءه۴ كما هو موضح في الرماز التالي: 


لا تعتبر هذه التقنية شائعة الاستخدام و لكنها قد تكون مفيدة جداً في بعض الأحيان. 


ذکرنا سابقاً ضمن هذه الجلسة أن عنصر تحكم 1٥١۴۵ء4‏ لمل يعمل في الخلفية بشكل غير متزامن مما يسمح للمستخدم باستمرار 
العمل على الصفحة. 

المشكلة تكمن في الزمن الذي قد تأخذه أحد الطلبات غير المتزامنة. في هذه الحالة قد يظن المستخدم أن التطبيق لا يتجاوب ويقوم 
بإعادة ضغط الزر لأكثر من مرة. 

تتسبب هذه المشكلة بتوليد عمل إضافي وعبء على التطبيق وبالتالي تزيد من بطئ التطبيق أكثر فأكثر. 

يتمتل الحل الذي توفره 16. ۸p‏ في عنصر تكم Update Progress‏ . 

يعمل عنصر التحكم هذا مع عنصر تحكم 1هة#۴ةلص[ا. ويمكن من إظهار رسالة في أثناء تخديم الطلبات غير المتزامنة التي 
تستهلك وقتاً طويلاً نسبياً. 


إظهار محاكاة لشريط التقدم 


يمكننا عند إضافة عنصر تحكم كوعإعهإ۴ ءلمل تحديد مكونات تظهر حال بدء الطلب الغير متزامن و تختفي عند إنتهائه. 

تتضمن المكونات الممكن إظهارهاء الصور الثابتة أو المتحركة من نمط 61۴ 4 هدمه لأنها توحي بشكل فعال أكثر أن الصفحة ما 
تزال تعمل. 

يظهر الشكل التالي صفحة تقوم باستخدام عنصر تحكم كوءإع٠هإ۴‏ ءادل مل في ثلاث نقاط من دورة عملها. 


تمثل المشاهد التالية وحسب شكل الصفحة الحال التي ستظهر عليها الصفحة قبل تلقي الطلب غير المتزامن و عند بداية تنفيذ الطلب 
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النص البرمجي لعمل هذا التطبيق هو على الشكل: 


لا تعتبر هذه هي الطريقة الوحيدة لاستخدام عنصر التحكم sوعإعهإ۴ءdatم‏ € إذ يمكن واعتماداً على التوزيع المطلوب إضافة عنصر 
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تحكم Update Progress‏ ضمن عنصر ت>ۃ .UpdatePane1‏ 


يتميز النص البرمجي في هذه الحالة بفارق طفيف عن الحالات السابقة يتمثل بتمكين إظهار محتوى العنصر كءع ۲٥۴۲ع at‏ لم € فقط 


عند كون الطلب قيد التنفيذ. 


يمكننا إضافة أسطر إضافية لمحاكاة عملية بطء التنفيذ و ذلك كما يلي: 


protected void cmdRefreshTime_Click(object sender, EventArgs e) 


System.Threading.Thread.Sleep(TimeSpan.FromSeconds(10)); 
IbITime.Text = DateTime.Now.ToLongTimeString(); 


} 


لا حاجة لإجراء عملية ربط خاصة لعنصر التحكم ؟یءع اع ٥21۴ل‏ مل مع عنصر تحکم 1٥٣۴2ءtھل‏ مل حيث يقوم عنصر تحكم 


ProgressTen plate بلlall بإظهار محتوی‎ €pdateProgress 


عند مباشرة أي عنصر 1٤۴4هل‏ مل بطلب غير متزامن. 


على كل حال عند العمل ضمن صفحة معقدة تحتوي أكثر من عنصر تحكم ٥1‏ ۴ ةلم يمكننا التحكم بحصر استجابة عنصر تحكم 


865َسِْْpdateProgr€U‏ بواحد من هذه العناصر فقط. 


يكفي لتطبيق هذه المقاربة إسناد قيمة معرف (1 الخاص بعنصر 1٥١4٣ءهل‏ مل إلى الخاصة 


.pdateProgress.AssociatedUpdatePanelID‏ حتى أنه من 


الممكن ضمن هذا السياق إضافة أكثر من عنصر تحكم 


ئئdateProgre Up‏ وربط کل منھا بعنصر تحکم ۴1٤1‏ ھلم مختلف. 


الإلغاء 
توفر عناصر تحکم ۶۶٥إعهإ۴ء‏ هلما إمكانية تحديد زر إلغاء. 
عند نقر المستخدم على هذا الزر ستتم عملية إلغاء فوري للطلب غير 
وتعود الصفحة إلى حالتها الأصلية. 
إن عملية إضافة زر إلغاء هي إجرائية بمرحلتين: 
1. إضافة نص أم1إ٥۷5ه[‏ بشكل حرفي إلى نهاية رماز الصفحة 
في الرماز التالي: 


المتزامن»ء وسيتم إخفاء محتوى العنصر Update Progress‏ 


بعد جميع المكونات وقبل إغلاق التأشيرة <رلهط/> كما يظهر 


<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Waitlndicator.aspx.cs" 


Inherits="Waitlndicator" %> 
<html xmins="http://www.w3.org/1999/xhtmlI"> 
<head runat="server"> 


</head> 
<body> 
<form id="form1" runat="server"> 


</form> 

<script type="text/javascript"> 

var prm = Sys.WebForms.PageRequestManager.getlnstance(); 
prm.add_initializeRequest(InitializeRequest); 

function InitializeRequest(sender, args) 

{ 

if (prm.get_islnAsyncPostBack()) 

{ 


args.set_cancel(true); 


} 
function AbortPostBack() 


{ 
if (prm.get_islnAsyncPostBack()) { 
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2. بعد إضافة هذا النص البرمجي يمكننا استدعاء الطريقة ())ء182ء٠0۲۲۴ط۸‏ في أي وقت لإلغاء عملية الإرسال غير المتزامن. 
تعتبر أسهل طريقة للوصول إلى هذا الهدف وصل حدث ام1إء؟هvه[‏ بالطريقة ۸0۲۲۴٥18 2٥))(‏ باستخدام واصفة حدث 
.JavaScript‏ 

يمكننا إضافة واصفة حدث امذإ٥8ة۷ه[‏ لأي عنصر _ا11۷M.‏ فعلى سبيل المثال يمكن التعامل مع حدث النقر من جهة الزبون 
باستخدام الواصفة )ع1آاع"ه. 


يستخدم الرماز التالي هذه التقنية لربط زر مع التابع .AbortP۴0s8ac))(‏ 


عند النقر على هذا الزر سيتم إطلاق التابع ۸00۲۲۴٥۶18 2٥))0‏ وسيتم إيقاف عمليات الاستدعاء غير المتزامن ۆز | 
الاستخدام النمطي لمثل زر الإلغاء هذا هر ضمن عاهام 1٤۴1‏ ءءءإعهإ۴ الخاص بعنصر تحكم ككعإعهإ۴ ءلمل كما يظهر في 
الشكل: 


@ Test Tage Windows Internct Explorer 


kk ا‎ > E hitpflocalhostS0901/Aja/Waitlndicator.aspx  _ F cator.aspx 


Start the Refresh Process 


Contacting Sever ... 
Lg @ Internet | Protected Mode: On RIOR * 


التحديث وفق فاصل زمني 


يحتاج المستخدم أحياناً إلى تمكين عملية تحديث الصفحة دون انتظار أي فعل من المستخدم. 

a 
دقائق مثلا). يمكن في هذه الحالة استخدام عنصر التحكم 11۳6۲ الذي توفره ۸8۴.۴۲ و الذي يسمح بتنفيذ هذا التصميم بسهولة.‎ 
يكفي لاستخدام عنصر التحكم هذا إضافته إلى الصفحة وتحديد فاصل التحديث كما يلي:‎ 


ملاحظة: لا بد من التفكير ملياً قبل استخدام عنصر التحكم ١٥ط11‏ ضمن التطبيق لما يضيفه من عبء على التطبيق وتأثيره على تفليل 
قابلية التوسيع كذلك يجب محاولة إبقاء زمن التحديث أطول ما يمكن. 
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يقوم المخدم بإطلاق حدث 11٥k‏ والذي يمكن معالجته لتحديث الصفحة. 

يمكن أيضاً الاعتماد على أحداث أخرى مثل 1044.#ع۴4, لأن عنصر التحكم 11۳۲ يقود إلى إطلاق كامل دورة حياة الصفحة مع 
کل ظهور لحدث چ»1اآ. 

يناسب عنصر التحكم ٠1٥١‏ الصفحات التي تستخدم التصيير الجزئي. 

لاستخدام عنصر التحكم 1"۲ مع التصيير الجزئي نقوم بتضمين الجزء المطلوب تحديثه من الصفحة في عنصر تحكم 
UpdatePane1‏ مع الانتباه إلى إسناد القيمة ٣21‏ 10ا كمه إلى الخاصة عل 0 ۷Mع‏ هلم ثم إضافة قادح لقسر عملية التحديث مع كل 
ظهور للحدث 11۳٥۲.1۲)‏ كما يوضح الرماز التالي: 


<asp:UpdatePanel |ID="UpdatePanel1" runat="server" Update Mode="Conditional'""> 
<ContentTemplate> 


</ContentTemplate> 

<Triggers> 

<asp:AsyncPostBackTrigger Controll[D="Timer1" EventName="Tick" /> 
</Triggers> 

</asp:UpdatePanel> 


ملاحظة: لا بد من استعمال القادحات مع عنصر تحكم "٥۲‏ 11. لن تتمكن ببساطة من وضع هذا العنصر ضمن عنصر تحكم 
UpdatePanel‏ لأنه سيقوم في هذه الحالة بإعادة إرسال الصفحة بشكل كامل مع ارتجاف في الصفحة. 


لإيقاف عنصر تحكم 11,٥١‏ يمكنك ببساطة إسناد القيمة ٥ء[ه٤‏ إلى الخاصة £121٥4‏ في الرماز من جهة المخدم. 


يبين الرماز التالي كيف تتم عملية إلغاء تفعيل عنصر التحكم ٣۳ص1"‏ بعد عشر تحدیثات: 
protected void Timer1_Tick(object sender, EventArgs e)‏ 


/l Update the tick count and store it in view state. 
int tickCount = 0; 
if (ViewState["TickCount"] != null) 


tickCount = (int)ViewState["TickCount"]; 


tickCount++t; 

ViewState["TickCount"] = tickCount; 

/l Decide whether to disable the timer. 
if (tickCount > 10) 


Timer1.Enabled = false; 


} 


عناصر تحکم أدوات ×ھز۸ في ۸8۴.۸٤7‏ 


مجموعة أدو ات ×۸۸ عدا عناصر تحکم UpdateProgress «Update Pane]‏ وimer"‏ هي مشروع مشترك بین Micr٥0۴‏ 
.ASP.NET Community s‏ 

يتضمن هذا المشروع عشرات عناصر التحكم التي تستخدم مکتبات ×۸[۸ ۸8۴.٤۲‏ لإنشاء تأثيرات معقدة. 

اتجه العديد من المطورين إلى استخدام هذه المكتبات لعدة أسباب: 

المجانية. 

تتضمن كامل النص البرمجي لتمكين المطورين الطموحين من إجراء التعديلات على أي عنصر تحكم. 

تستخدم موسعات لتحسین عمل عناصر تحكم الوب في ۴1 .۸8۴.۸N‏ 
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مثال استخدام عنصر تحکم :Acc0۲d10۸‏ 
عنصر تحكم ۸٥٥0۲101‏ هو عبارة عن حاوية تقوم بمراكمة مجموعة من اللوحات فوق بعضها البعض وتمكن رؤية محتوى أحدها 


فقط في وقت واحد. 

ن امن ف ا عات و وة هة حه و ار وه ك رضن مون ال 

يوضح الشكل التالي كيف يبدو عنصر تحكم lla Accordion‏ من تلاٽ glوڪIٽ .(Colors, Text, Other)‏ 
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في المرة الأولى التي يتم فيها تحميل الصفحة يتم تحميل جميع اللوائح وتصييرها إلى لغة ا11 ولكن يتم إخفاؤها باستخدام أنماط 
.CSS‏ 

عند نقر الترويسة يقوم تابع ما٥4۷8[‏ بالعمل وتغيير واصفات هذه الأنماط لإظهار محتوى اللوحة التي تم النقر على ترويستها 
وإخفاء محتوى اللوحة السابقة. 

يمكن باسناد القيمة عد إلى الخاصة ١0نازورهإ‏ ل۴4 إعطاء مظهر أكثر إنسيابية لحركة الإظهار تلك 

النص التالي يوضح البنية التي يتم استعمالها لوضع عنصري ۸-c0۲10۸ ۴21٥‏ ضمن عنصر تحکم :Accordi0۸‏ 


ملاحظة: 
- يمكننا استخدام الخاصة × ل,41ء†ءء1ءS.«هiلإهءءA‏ لتحديد اللوحة التي سيتم إظهارها من لوائح عنصر تحكم 
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Accordion 
إلى الخاصة ع”ة۵۴ء١”ءم40ءi۲ايهR سيتم إظهار محتوى أحد اللوائح بشكل تلقائي أي لن‎ ]]u# في حال إسناد القيمة‎ - 


نتمكن من إغلاق جميع اللوائح في آن معا 


یتکون کل عنصر تحکم 1۴۵8 ل0۲٥۸‏ من مقطعین اساسیین: 
- الرأس: يستخدم لإظهار اسم اللوحة وكزر قابل للضغط لتأمين فتح و إغلاق اللوحة. 
- المحتوى: يحمل هذا الجزء العناصر التي تود تضمينها في هذه اللوحة. 


.5 فيما يلي الرماز الواجب استخدامه للحصول على الواجهة المبينة في الشكل رقم‎ 
<ajaxToolkit:Accordion ID="Accordion1" runat="server" 
HeaderCssClass="accordionHeader" 
HeaderSelectedCssClass="accordionHeaderSelected" 
ContentCssClass="accordionContent"> 
<Panes> 
<ajaxToolkit:AccordionPane runat="server"> 
<Header>Colors</Header> 
<Content> 
Choose a background color:<br /> 
<asp:DropDownList id="IstBackColor" runat="server" 
Width="194px" AutoPostBack="True"> 
<l/asp:DropDownList> 
<br /><br /> 
Choose a foreground (text) color:<br /> 
<asp:DropDownList id="IstForeColor" runat="server" 
Height="22px" Width="194px" AutoPostBack="True" > 
</asp:DropDownList> 
</Content> 
<l/ajaxToolkit:AccordionPane> 
<ajaxToolkit:AccordionPane runat="server"> 
<Header>Text</Header> 
<Content> 
Choose a font name:<br /> 
<asp:DropDownList id="IstFontName" runat="server" 
Height="22px" Width="194px" AutoPostBack="True"> 
<lasp:DropDownList> 
<br /><br /> 
Specify a font size:<br /> 
<asp:TextBox id="txtFontSize" runat="server" 
AutoPostBack="True"> 
</asp:TextBox> 
<br /><br /> 
Enter the greeting text below:<br /> 
<asp:TextBox id="txtGreeting" runat="server" 
Height="85px" Width="240px" TextMode="MultiLine" 
AutoPostBack="True"> 
<lasp:TextBox> 
</Content> 
<lajaxToolkit:AccordionPane> 
<ajaxToolkit:AccordionPane runat="server"> 
<Header>Other</Header> 
<Content> 
Choose a border style:<br /> 
<asp:RadioButtonList id="IstBorder" runat="server" 
Height="59px" Width="177px" Font-Size="X-Small" 
AutoPostBack=" True" RepeatColumns="2"> 
</asp:RadioButtonList> 
<br /><br /> 
<asp:CheckBox id="chkPicture" runat="server" 
Text="Add the Default Picture" AutoPostBack="True"> 
<l/lasp:CheckBox> 
</Content> 
<lajaxToolkit:AccordionPane> 
</Panes> 
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AutoComplete Extender pS<تll‎ رصieع‎ 


ليست جميع عناصر تحكم أدوات ×۸[۸ في ۸8۴.۴1 هي عناصر تحكم جديدة كلياً مثل عنصر التحكم 00۸٥ء۸‏ بل هي في 
مها مرسعات لضاف مزا ج اضر كك 6 A88‏ اة 

تمكن هذه الموسعات من استخدام نفس التأثير ات على عدد كبير من عناصر التحكم. 

تصبح هذه المقاربة مفيدة جداً عندما نتعامل مع ميزة متعددة الأغراض مل الإتمام الîلي .AutoComplete Extender‏ 

يمكن عنصر التحكم e۲۲‏ ل۸ ءا>8ءاء1مصه0اAu‏ من إظهار قائمة بالاقتراحات أثاء تحرير المستخدم لمحتوى أحد عناصر التحكم 
النصية. 


يبین يبين الشكل َّ شکل عنصر تحکم AutoCompleteExtender‏ اء العمل مع عنصر تحكم 1٥×80×‏ عادي. 


Î Untitled Page - Windows Internat Explorer 


© arenes TX 


Cantact Name: 

Manuel Parpîra 
Marna Anders 
Mana Larsson 
Marie Bertrand 
Mario Pontes 
Martin Sommar 
Martine Rancê 
Mary Saveley 
Matti Karttunen 
Maurizio Morohî 


Lg @ Iremet | Protected Mode: ûn 
عندما يبدا المستخدم بالكتابة ضمن العلبة النصية تظهر قائمة تقدم مجموعة من الاقتراحات.‎ 
عندما ينقر المستخدم على أحد هذه الخيارات من القائمة يتم نسخ نص هذا الخيار إلى العلبة النصية.‎ 
يلزمنا لتطبيق هذا المثال عنصر تحكم علبة نصية عادية:‎ 


بعد إضافة العلبة النصية يجب إضافة عنصري تحكم ScriptM anager‏ و eteExtenderاmp .Auto c0‏ يتم الاستحصال على قائمة 
الاقتراحات التي يقدمها عنصر التحكم Auto ompاetء ٤x) e1٤۲‏ من إجرائية خاصة سنحتاج لإنشائها ضمن صفحتتا. 

لربط عنصر التحكم Auto 0m pاetع Extender‏ بعنصر تحکم ما نستخدم الخاصة ٦ ۲عء۲٣ ٥٥٤۲٥115‏ حیث نقوم بإسناد قیمة 15 
الخاصة بعنصر التحكم المراد الربط معه إلى هذه الخاصة. 

تحدد الخاصة طاع MinimumP refx]‏ عدد المحارف التي يجب كتابتها قبل تقديم أي إقتراح لإظهار قائمة الإتمام الآلي. 

تحدد الخاصة 04طء۷NءءاامS‏ اسم طريقة الوب التي سيتم استخدامها للحصول على قائمة الاقتراحات. 


لا بد من إنشاء طريقة الوب كع٣‏ ١ء6‏ ليعمل هذا المثال بنجاح. 
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[System.Web.Services.WebMethod] 
[System.Web.Script.Services.ScriptMethod] 
public static List<string> GetNames(string prefix Text, int count) 


{...} 

تقبل طريقة الوب المعرّفة معاملين يحددان النص الذي كتبه المستخدم وعدد المقترحات المطابقة المراد إظهارها (القيمة الافتراضية هي 
0 لهذا المعامل). 
تحدد الواصفتان السابقتان للطريقة sمصة١ء6‏ أن هذه الطريقة هي طريقة وب بمعنى أن الزبون يستطيع استدعاءها بشكل مباشر 
باستعمال طلبات 1١۲۶‏ وبأنها تدعم الاستدعاء باستخدام أم۲ ۷86[ (وهي الطريقة التي يستخدمها عنصر 
.(AutoCompleteExtender‏ 
كثابة النص البرمجي الذي سيقوم بالاستحصال على المقترحات فد يكون مرهقا بعض الشيء» سنستخدم في مثالتا قائمة من الأسماء يتم 
الاستحصال عليها من قاعدة البيlنlاٽت .North Wind‏ 
للتأكد من أن هذه العملية ستتم لمرة واحدة وليس كل مرة يتم فيها التعامل مع عنصر مرتبط مع 1 Auto C0 m1e†e٤×)e‏ نلجأً 
عادة إلى استخدام الذاكرة الخبيئة كما يوضح الرماز التالي: 

List<string> names = null; 


// Check if the list is in the cache. 
if (HttpContext.Current.Cache["NameList"] == null) 


{ 

// If not, regenerate the list. The ADO.NET code for this part 

// isn't shown (but you can see it in the downloadable examples 
/1 for this chapter. 

names = GetNameListFromDB(); 

// Store the name list in the cache for sixty minutes. 
HttpContext.Current.Cache.Insert("NamelList", names, null, 
Date Time.Now.AddMinutes(60), TimeSpan.Zero); 

1 


else 


// Get the name list out of the cache. 
names = (Lists<string>)HttpContext.Current.Cache["NameList"1; 


المرحلة التالية في هذا النص هي مطابقة عناصر القائمة لإيجاد العناصر التي تبدأً بنفس الأحرف التي تمت كتابتها: 


int index = -1; 
for (int i = 0; i < names.Count; i++) 


/l Check if this is a suitable match. 
if (names[i].StartsWith(prefixText)) 


index = i; 
break; 


} 


/l Give up if there isn't a match. 
if (index == -1) return new List<string>(); 


بعده يبدأ الرماز الخاص بالبحث بدليل الموقع الحالي وينتقل عبر اللائحة ويحاول الاستحصال على عشرة اقتراحات. فإما أن يصل إلى 
نهاية القائمة أو يجد قيمة لا تطابق السابقة التي تم إدخالها فيوقف البحث. 


List<string> wordList = new List<string>(); 
for (int i = index; i < (index + count); i++) 


{ 

// Stop if the end of the list is reached. 
if (i >= names.Count) break; 

// Stop if the names stop matching. 
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الحصول على المزيد من عناصر تحكم آدوات ۸j4×‏ 


عناصر Accordion‏ و eteExtenderاp Auto Com‏ هي أمثلة بسيطة عما تحتويه مكتبة أدوات ×٤۲‏ .۸8۴ العناصر 
والتي تحتوي على أكثر من 30 عنصر مكون. 
الطريقة الأسهل للبدء باستكشاف عناصر التحكم الأخرى قم بزيار ة الموقع )اھ ×٥‏ ۾jھ/اھہ.مspھ.>ھزھ//:tp‏ حیث یمکن إیجاد 
مراجع تصف كل عنصر و طريقة عمله و تمكنك من اختباره مباشرة عن طريق الموقع. 
من أهم عناصر التحكم المفيد استكشافها: 


AlwaysVisibleControlExtender, AnimationExtender, CalendarExtender, DragPanelExtender, 
DynamicPopulateExtender, Filtered TextBoxExtender, HoverMenuExtender, ListSearchExtender, 


ModalPopupExtender, MutuallyExclusiveCheckboxExtender 


NumericUpDownExtender, PagingBulletedListExtender, PasswordStrength Extender, 


PopupControlExtender, RatingResizableControlExtender, SlideShowExtender, TabContainer, 
TextBoxWatermark 
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الفصل الثالث عشر 
الخبء في AS۲۴.۸N ٤۲‏ 


يتعرف الطالب في هذه الجلسة على: 
1- مفهوم الخبء في تطبيقات الوب 
2- متى نستخدم الخبء 
3- أنواع الخبء التي تدعمها ۸8۲.۴1 و كيفية استخدامها 


الخبء 


تختلف تطبيقات الوب بشكل عام عن تطبيقات سطح المكتب كونها تحتاج إلى متطلبات خاصة متل الحاجة لتخديم عدد كبير من الزبائن 
بشکل سریع و بسیط. 

تغري بيئة 48۴.٤1‏ المطورين باستخدام العديد من الميزات التي قد تقود أحياناً إلى نسيان المطور أنه يعمل على تطبيق وب. 
يؤدي استخدام هذه التقنيات أو الآليات إلى إبطاء أو حتى إعاقة عمل التطبيق. 

لحسن الحظ يمكن أن نبني تطبيق يستفيد من المميزات الكثيرة التي تمنحها ۸5۴.٤1‏ مثل طرق إدارة الحالة المختلفة وعناصر تحكم 
الوب. 

سيحتاج المطور للمزيد من الوقت في عملية ضبط الأداء للموقع. 

أحد أسهل الطرق لتحسين الأداء هي الخبء. في عملية الخبء يتم تخزين المعلومات القيمة بشكل مؤقت على ذاكرة المخدم ليتم إعادة 
استخدامها لاحقاً. 

إن عملية الخبء و بعكس ما رأيناه فى الطرق المختلفة لإدارة الحالة تتضمن آلية مبيتة تكفل الأداء الجيد للتطبيق. 


الخبء في ASP.NET‏ 


تمت العديد من التطويرات على الخبء في ۸8۴.٤1‏ منذ النسخ الأولى حيث تمت زيادة فعالية المزايا المضمنة في هذه الآلية بشكل 
يرفع الأداء في بعض السيناريوهات بشكل كبير. 

يستخدم الخبء عادة لتخزين المعلومات التي يتم الاستحصال عليها من قاعدة البيانات لغرض توفير الوقت اللازم لإعادة استعادتها في 

كل مرة. 

يمكن بعملية ضبط للأداء باستخدام الخبء تخفيض العبء للحد الأدنى» حيث سيتم الحصول على بعض المعلومات المطلوبة من ذاكرة 
الخبء عوضاً عن إعادة الاستعلام عنها من قاعدة البيانات. 

ليست عملية تخزين المعلومات ضمن الذاكرة دائماً فكرة جيدة. إن ذاكرة المخدم هي مورد محدود» ستؤدي المبالغة في استخدامها إلى 

تخزين الأجزاء الفائضة على القرص الصلب مما سيقود النظام كاملا إلى حالة من انخفاض في الأداء. 

لهذا تم العمل على جعل تقنية الخبء في ۸8۴.NE١‏ ذاتية المحدودية. حيث غالبا ما يتم توفير المعلومات التي يتم خبؤها ضمن ذاكرة 


Universal Knowledge Solutions s.a.1. 
194 


المخدم. 
يظل زمن الاحتفاظ بهذه االمعلومات ضمن إدارة المخدم. فإذا امتلأت ذاكرة المخدم أو حصل استهلاك كبير للذاكرة من قبل التطبيقات 
العاملة ستتم عملية إخلاء اصطفائية لذاكرة الخبء وستتابع التطبيقات عملها بأداء جيد. 


متى نستخدم الخبء 


يكمن السر الأساسي في الاستفادة الأعظمية من الخبء في اختيار الزمن المناسب لاستخدامها. 

من استراتيجيات الخبء الناجح التركيز على تخزين المعلومات الأكثر استخداماً و التي تستهلك زمن كبير نسبياً لإنشائها وتخزينها. 
إن خبء معلومات غير مهمة نسبياً قد يؤدي إلى إجبار إخلاء معلومات أكثر أهمية. 

هناك نقطتين أساسيتين ينصح بمراعاتهما عند استخدام الخبء: 

قم بخبء البيانات عالية الكلفة. 

قم بخبء البيانات المستخدمة بكثرة. 

يمكن بمراعاة هاتين النقطتين الوصول إلى أداء أعلى و قابلية أكبر للتوسع. 


الخبء في ASP.NET‏ 


للخبء في 8P. NET‏ نوعان اساسیان: 
- خبء الخرج: وهو أبسط أشكال الخبء. يتم الاحتفاظ في هذا النوع من الخبء بنسخة عن صفحة 11۷11 التي تم تصييرها 
وإرسالها إلى الزبون. 
خبء البيانات: تتم هذه العملية يدوياً ضمن الرماز الذي يكتبه المطور. حيث يتم تخزين الأجزاء الهامة من المعلومات التي 
تستهلك وقتاً لإنشائها. يعتبر خبء البيانات من حيث المفهوم مشابهاً لحالة التطبيق لكنه يعتبر حل أفضل بكثير من وجهة نظر 
التأثير على أداء المخدم. 


هناك أيضاً نوعان خاصان من الخبء يمكن استخدامهما بالاعتماد على النوعين الرئيسيين أعلاه: 


HTML الخبء الجزئي: يعد هذا النوع من الخبء حالة خاصة من خبء الخرج حيث يتم تخزين أجزاء من خرج صفحة‎ ٠ 
المرسل إلى الزبون عوضاً عن خبء كامل الصفحة.‎ 
Sq12a)a50u ce خبء مصادر البيانات: يعبر هذا النوع من الخبء عن القدرة المبيتة لدى عناصر تحكم البيانات مثل‎ 
على خبء البيانات. يستخدم هذا النوع من الخبء ناء طريقة خبء‎ ObjectDataSource و‎ XMLDataSource و‎ 
البيانات. يكمن الاختلاف في أن المطور ليس بحاجة أن يعالج العملية بشكل صريح إذ يكفي إعداد الخصائص المناسبة ليقوم‎ 
عنصر تحكم مصدر البيانات بإدارة عملية خبء» تخزين واستعادة البيانات تلقائيا.‎ 


خبء الخرج 


يتم في هذا النوع كما ذكرنا خبء كامل صفحة 111 و عند طلب الصفحة مرة أخرى لن تتم إعادة إنشاء أغراض عناصر التحكم 


Universal Knowledge Solutions s.a.1. 
195 


أو إعادة دورة حياة الصفحة من جديد كما لن يتم تنفيذ أي رماز بل سيتم إعادة إرسال النسخة المخزنة من الصفحة إلى الزبون. 
لنتمكن من رؤية عمل خبء الخرج سنقوم ببناء صفحة بسيطة تظهر الوقت الحالي كما هو موضح في الشكل أدناه: 
Untitled Page - Windouws Internet Explorer 3‏ ھ 


a0 ¥ E http: localhost S106 Caching OutputCachirg.aspx 


The time i5 NnOW: 
1/1/2008 12:44:56 PM 


Lg @ Intenet | Protected Mode: On 


أما الرماز فهو كما يلي: 


الطريقة الأكثر شيوعاً لتفعيل خبء الصفحة: هي إضافة الموجه هام0 في بداية ملف ×مءه تحت موجه الصفحة تماماً: 
OutputCache Duration="20" VaryByParam="None" %>‏ @%< 

يستخدم معامل (110١‏ لتحديد الفترة التي سيتم فيها خبء الصفحة و هي 20 ثانية في مثالنا. 

المعامل ۴2۲2۳ 8راه۷ هو معامل إلزامي سنؤجل شرحه إلى مرحلة لاحقة ضمن هذه الجلسة. 

عند تشغيل هذا المثال سنلاحظ بأن أي عملية تحديث ضمن فترة لا تتجاوز 20 ثانية سوف لن تؤدي إلى تحديث الوقت و التاريخ 

الحالي. 


إن الزمن الذي سيتم الاحتفاظ خلاله بنسخة عن الصفحة هو 20 ثانية فقط في حال لم يتم إخلاء الصفحة قبل ذلك من ذاكرة الخبء 
بسبب امتلائها. 


الخبء من طرف الزبون 
أحد الخيارات المتوفرة للمطور هي الخبء من طرف الزبون. 


في هذه الحالة يقوم المستعرض بتخزين نسخة من الصفحة. تستخدم هذه النسخة عند عودة الزبون إلى الصفحة أو عند إعادة كتابة 
اسمها ضمن شريط الغنوان: 
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سيتم إهمال النسخة المخزنة على الزبون في حال ضغط الزر ۸٠۴۲٠١1‏ وسيعاد طلب الصفحة من المخدم. 
يمكن خبء صفحة من طرف الزبون باستخدام الواصفة 1.0٥210١‏ ضمن الموجه 1ء2 ٣uما0u‏ والتي تحدد قيمة من الترقيم 
System.Web. U1.OutputCacheLocation‏ کما هو موضح أدناه: 


لا يقدم الخبء من جهة الزبون فائدة ممائلة لتلك التي يحققها الخبء من جهة المخدم لأنه لايمنع بناء نسخ مختلفة لكل مستخدم ولكنها 
تظل طريقة مفيدة يمكن أن تساهم في تخفيف العبء عن المخدم و بالأخص عند العمل مع التطبيقات التي تعتمد على تخصيص 
البيانات. 


الخبء و سلسلة محارف الاستعلام 


أحد أهم الأمور التي يجب مراعاتها في خبء البيانات هي متى يجب إعادة استخدام البيانات المخزنة ومتى يجب إعادة طلبها مرة 
أخرى. 

نستخدم لتسهيل عملية اتخاذ القرار بهذا الخصوص ضمن التطبيق الو اصفة By ٣24۳‏ ,إ۷ ضمن llئnموج4 .OutputCache‏ 

تمكن هذه الواصفة ۸8۴.٤1‏ من تحديد خبء نسخة واحدة من الصفحة أو مجموعة من النسخ. 

يمكن N٤1‏ .۸8۴ تخزين نسخ تختلف عن بعضها البعض بأحد أو جميع المعاملات التي يتم تمريرها ضمن سلسلة محارف 
lلlتعںم .(Query String)‏ 

استخدمنا في المتال السابق القيمة "٠٣٥‏ للواصفة 74۲/8۷۶۵۲4۳ . تحدد هذه القيمة خبء لنسخة واحدة من الصفحة. 

لتمكين عملية خبء نسخة جديدة مع كل تغيير في أي معامل ضمن سلسلة محارف الاستعلام نسند القيمة * إلى الواصفة 
.VaryByParam‏ 

لتحديد معامل أو مجموعة معاملات ليتم أخذها بعين الاعتبار عند خبء نسخة جديدة يكفي وضع أسماء هذه المعاملات مفصولة بفاصلة 


منقوطة ضمن قيمة الواصفة ۷۲8۲4۲4۳ أي من الشكل: 


يستخدم المثال التالي صفحتي وب لتوضيح كيفية خبء أكثر من نسخة من صفحة وب بشكل منفصل. 
توفر الصفحة الأو QueryStrَingSender.aspx JÛ‏ واجهة تحتوي ثلاثة أزرار كما يبين الشكل: 
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€ Untitled Page - Windows Internet Explorer - 


G0. E| http flocalhost:53106/Caching/QueryStringSender.aspx ا‎ 


r [@untmearage @ Untitled Page 


omall Wersion | 


۳ Û Internet | Protected Modz: On R100 < 


م الأزرار الثلاثة مقبض معالجة حدث وحيد يقوم بالانتقال إلى QueryStringRecipient.aspx FE‏ مع إضافة معامل 
يحدد رقم النسخة إلى سلسلة محارف الاستعلام كما في الرماز التالي: 


protected void cmdVersion_Click(Object sender, EventArgs e) 


{ 


Response.Redirect("QueryStringRecipient.aspx" + "?Version=" + 
((Control)sender).ID); 
} 


تستخدم الصفحة ×مكه.٤”ع¡مQueryStringReci‏ رسالة إظهار التاريخ والوقت التي قمنا باستخدامها في مثالنا السابق ضمن هذه 
الجلسة مع فارق إسناد القيمة ١10ء۲٥۷‏ إلى الواصفة 8۲۴2۲۳ ary‏ ۷ ضمن موج4 :OutputCache‏ 
OutputCache Duration="60" VaryByParam="Version" %>‏ @%< 
لتمييز النسخ المختلفة التي سيتم خبؤّها بحسب تغير الواصفة ۷4۲8/۴3۲۵۳١‏ سنقوم بتغيير حجم الخط ضمن مقبض حدث تحميل 
الصفحة بحسب قيمة هذا المعامل ۷٥۲۹10٧‏ كما يلي: 
protected void Page_Load(Object sender, EventArgs e)‏ 


IbIDate. Text = "The time is now:<br />" + DateTime.Now.ToString(); 
switch (Request. QueryString["Version"]) 
{ 

case "cmdLarge": 

IbIDate.Font.Size = FontUnit.XLarge; 
break; 

case "cmdNormal": 

IbIDate.Font.Size = FontUnit.Large; 
break; 

case "cmdSmall": 

IbIDate.Font.Size = FontUnit.Small; 
break; 

} 

1 


التحكم المخصص بالخبء 


ليس استخدام التغير في سلسلة محارف الاستعلام هو الطريق الوحيد لخبء نسخ متباينة من صفحة ما. 
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تمكن ۸8۶.٤1‏ من إنشاء إجرائية خاصة مهمتها تحديد الحاجة إلى خبء نسخة جديدة من الصفحة. 
تستخدم لهذا الغرض llلخاصة .VaryByCustom‏ 
أحد الاستخدامات الممكنة لهذا النمط من التحكم المخصص بالخبء هو تمكين خبء نسخة جديدة من الصفحة عند اختلاف المستعرض 
المستعمل. 
يجب أن يضاف الرماز التالي إلى أعلى الصفحة المراد خبء نسخ منها: 
OutputCache Duration="10" VaryByParam="None" VaryByCustom="Browser" %>‏ @%< 
تستلزم المرحلة التالية كتابة النلص البرمجي للإجرائية المسؤولة عن تحديد خبء نسخة جديدة. 
يوضع الرماز التالي ضمن ملف التطبيق ×هوه.21طه[6: 


الخبء الجزئي: 
يكتشف المطور في بعض الأحيان أنه لن يكون بإمكانه خبء كامل الصفحة لذلك يلجأ إلى خبء الجزء ذو التعقيد الأعلى والأكثر كلفة 
من حيث زمن البناء و التخزين و التي لا تتغير بشكل كبير نسبياً. 
لنتمكن من استخدام الخبء الجزئي علينا بناء عنصر تحكم مخصص يحتوي الجزء المراد خبئه من الصفحة. يمكن بعد هذا إضافة 
الموجه ع1٥2٣uما0u‏ إلى عنصر التحكم المخصص. 
لا يختلف مفهوم الخبء الجزئي عن المفهوم العام لخبء الصفحة بفرق واحد هو أن الصفحة لن تستطيع التفاعل مع محتوى عنصر 
التحكم الذي تمت استعادته من ذاكرة الخبء. 
فإذا وفر عنصر التحكم الذي تم خبئه على سبيل المثال مجموعة من الخصائص» لن يتمكن رماز الصفحة من الوصول إلى» أو تعديلء 
هذه الخصائص. 
ستتم إضافة كثلة 111 المخزنة كما هي ضمن الصفحة. 


إعدادات الخبء 


أحد المشاكل الأساسية لخبء الخرج هي ضرورة تضمين التعليمات ضمن الجزء الحاوي على التأشيرات في ملفات ×مءه أو الرماز 
الخاص بالصف. 
مع أن هذه الطريقة ليست سيئةء تصبح المشكلة أكثر تعقيداً في حال كان عدد الصفحات التي يتم تفعيل الخبء فيها كبيراً. 


Universal Knowledge Solutions s.a.1. 
199 


عندها تصبح عملية تغيير الإعدادات الخاصة بالخبء في كل الصفحات عملية مرهقة. 

تتضمن N٤1‏ .۸8۲ ميزة تدعى عااگهام عطعهء. تمكن هذه الخاصة من تعريف إعدادات الخبء لمجموعة من الصفحات ضمن ملف 
عweb.conf‏ » عندها يمكن ربط هذه الإعدادات مع عدد كبير من الصفحات. 

يكفي لتعديل إعدادات الخبء لجميع الصفحات تعديل الإعدادات من ضمن ملف عا۴دb.c0عمw.‏ 

لتعريف إعدادات خبء نقوم باستخدام التأشير ة <لله> ضمن القسم e<‏ ]۲۴۴1ع >outpu{٣ ach‏ كما يوضح المثال التالي: 


يمكننا استخدام الإعدادات التي تم تعريفها في أحد 


لتحديد تفاصيل أخرى متميزة لإحدى الصفحات يمكننا استخدام الموجه عطء4٣٤uما0u‏ أو استخدام التأشير ة <4> لتعريفه ضمن 
en‏ کی ۰ 1 .۰ . 


خبء البيانات 


يعتبر هذا الشكل من أشكال الخبء أكثر الأشكال مرونة › لكنه يتطلب خطوات إضافية ضمن النص البرمجي. 
الفكرة الأساسية في خبء البيانات أن يقوم المطور بشكل صريح بإضافة القيم والأغراض التي تعتبر عمليات إنشائهاء تخزينها مكلفة 
إلى غرض مجمو عة مبيت يدعى ع1ءه). 
الغرض ط٥2٥‏ هو أحد خصائص صف معه۴. حيث تعيد هذه الخاصة مثيJ ja‏ لصف .System. Web.Caching.Cache‏ 
يعمل هذا الغرض بشكل مشابه لغرض التطبيق ١٥1اهء1امم۸‏ الذي قمنا باستعراض عمله ضمن الجلسة الخاصة بإدارة حالة التطبيق. 
يختلف غرض ءطءه٥٤‏ عن غرض ١٥1هام‏ م بتلاث نقاط أساسية: 
- يدعم غرض 04٥10‏ الطابات المتزامنة: بمعنى أنه لا ضرورة لعملية إقفال وإلغاء إقفال الغرض 04٥1١‏ بشكل صريح عند 
إضافة» إزالة أو تعديل عنصر. 
- يتم إزالة العناصر من ذاكرة الخبء بشكل آلي. 
- دعم العناصر المرتبطة: أي هناك إمكانية لربط العناصر في ذاكرة الخبء بملف» جدول في قاعدة البيانات أو أي نمط آخر 
من الموارد. في حال تعديل أي من الموارد المرتبطة ستعتبر العناصر المخزنة في ذاكرة الخبء والمرتبطة به منتهية 
الصلاحية. 


إضافة عناصر إلى غرض ءطء4٣€:‏ 
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يمكن إدراج عنصر ضمن غرض عء1ءه) بعدة طرق. 
يمكن ببساطة استخدام اسم مفتاح جديد بالشكل: 


هذه الطريقة غير محببة كونها لا تقدم أي تحكم بالزمن الذي سيتم ستبقى فيه المعلومات ضمن ذاكرة الخبء. 
أحد الطرق الأخرى الأفضل للوصول إلى نفس النتيجة استخدام الطريقة 61)0ء,1 كما يلي: 


يوضح الجدول التالي المعاملات التي تستخدمها هذه الطريقة: 

المعامل الوصف 
key‏ سلسلة محرفية تحدد اسم العنصر الذي تم خبثه 
Item‏ الغرض المراد تخزينه ضمن ذاكرة الخبء 
Dependencies‏ غرض من الصف 1۷ع ل۸ءمء2ءطءهC‏ يسمح بإنشاء ارتباط 
مع مورد ما.يجب إسناد القيمة 11اه إلى هذه الخاصة في حال 
عدم وجود موارد مرتبطة. 
absoluteExpiration‏ غرض 541١11٣١‏ يمتل تاريخ ووقت إزالة العنصر المحدد 
من ذاكرة الخبء. 
slidingExpireation‏ الفترة بين طلبين على نفس العنصر قبل أن تقوم ASP.NET‏ 
بإزالته من ذاكرة الخبء.القيمة الأفضلية لهذا المعامل هي 20 


أمثلة عن استخدام هذه المعاملات هي: 


مثال بسیط 


المثال التالي يوضح كيفية استخدام الطريقة ١۲٥ء11‏ لخبء العنصر ١ء‏ (]اءع]. 
يتم تنفيذ الرماز في الصفحة في كل مرة لأن الخبء محصور بعنصر معين ولا يشمل الصفحة كلها. 
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يمثل الشكل التالي خر ج التطبيق عند النقر على زر )عمط ائمم. 


Ê lintîled Page- Windows Internet Feplarer 


+0 - Bl hito/rbcalhestS3106Cachina/SimokDetaCacae asm +] x×| 


HE 


1 1 Ep 7 hl 7 |p Page 7 1 


Page created. 
creating TestItEn... 
Storing Testitam in rarha for 30 seconds. 


Page posted back. 
Retrieving TestI[tem... 
Testltem I3 'l/1/20C8 12:47:09 2M" 


Page posted back. 
Retrieving TestItem... 
Tastltem I5 'l/1/240C8 12:47:03 2M" 


Page posted back. 
Creating Testltem... 
Storing Testtem ın cacha for 30 seconds. 


[# @ Irternet | Protected Mode: On 


الخبء بغرض توفير أكثر من مشهد 


يتم في المتال التالي تخزين غرض 13)5٥‏ ضمن ذاكرة الخبء. 
يوفر هذا الغرض مصدر البيانات لعنصر تحكم ۷1W‏ 6۲11. باعتماد خبء غرض اعءه)a ٥‏ غوظناً عن خبء عدد كبير من المشاهد 
التي تنتج عن عملية تخصيص الغرض 1۴W‏ 6۲11۷ كعرض أعمدة محددة فقط. 
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Û Untitled Page - Microsoft Internet Explorer 
Ele Edt Yjew Favorites Tonls telp GE” O ` 8 2 0 


Address E] htt: MHorzlhost:1422CachiraMultitleviews,aspx: 


He ColLmns: 

DOSustemerllEG MFEe3ion 
HGompanyMaras DIPostalCods 
DSontacstNname A Gountry 
l#AContactTitle ll Phane 
DAaddress E Fa: 

DIZity 


Created and added to cache. 


CustomerIG | ContactName :i PostalCode 
Maria Anders bere Str, 5F Berlin 


دا عل ,دلي 
٣ مدزiااد Gonstitucidn Mê xiza D,F,‏ 2ھ 
rE‏ 
ا Antonia Mataderas‏ 
ÊANTRH SEE 2412 Mê xiza D,F, USES‏ 
Fanoyer‏ 120 


AROUIT Thomas Hardy 3 


Landon A1 LDF 


Ghristina Berguvswãgen 


Berglund 3 3اا‎ S-398 22 


EER3S 


ElLA4lls Hanna Moos Forsterstr, SF Mannhszirm ES3UE 


Frédöriqıe 24, دام‎ 


Tita as Ela bar ا‎ 
Cî 2 
€) me ¥ Local intranet 0 


protected void Page_Load(object sender, EventArgs e) 


ELOHP Strasbourg éFODD 


{ 
if (!this.IsPostBack) 


{ 

DataSet ds = GetDataSet(); 

chkColumns.DataSource = ds.Tables["Customers"].Columns; 
chkColumns.DataTextField = "ColumnName'"; 
chkColumns.DataBind(); 

} 
1 


private DataSet RetrieveData() 
{ 
string connectionString = 
WebConfigurationManager.ConnectionStrings["Northwind"].ConnectionString; 
string SQLSelect = "SELECT * FROM Customers"; 

SqlConnection con = new SqlConnection(connectionString); 

SqlCommand cmd = new SqlCommand(SQLSelect, con); 

SqlDataAdapter adapter = new SqlDataAdapter(cmd); 

DataSet ds = new DataSet(); 

try 


con.Open(); 
adapter.Fill(ds, "Customers"); 


1 
finally 
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{ 


con.Close(); 


return ds; 


} 
{ 


con.Close(); 


return ds; 


} 


private DataSet GetDataSet() 


{ 

DataSet ds = (DataSet)Cache["Customers"]; 
// Contact the database if necessary. 

if (ds == null) 

{ 
ds = RetrieveData(); 

Cache.Insert("Customers", ds, null, Date Time.MaxValue, 
TimeSpan.FromMinutes(2)); 

IbIlCacheStatus. Text = "Created and added to cache."; 


} 


else 
IbIlCacheStatus. Text = "Retrieved from cache."; 


return ds; 


} 


الخبء باستخدام عنصر تحکم مصادر البيانات 


تدعم عناصر تحکم مصادر البیانات Xm]DataS0urce »ObjectDataSource «S1DataSource Jin‏ ميزة خبء البيانات المبيتة. 
ينصح باستخدام الخبء بهذه الطريقة لأن عملية الاستعلام من قاعدة البيانات تتكرر مع كل إعادة إرسال للصفحة كذلك يمكن أن تتم 


إعادة الاستعلام لکل عنصر مرتبط بمصدر البيانات. 


أي إذا كان لدينا ثلاثة عناصر تحكم مرتبطة بمصدر بيانات وحيد سينفذ الاستعلام ثلاث مرات. لذلك فإن تفعيل عملية الخبء في 


سيناريو مماثل سيؤدي إلى تحسن كبير في الأداء. 


توفر عناصر تحکم مصادر البيانات مجمو عة من الخصائص لدعم ميزة الخبء: 


الخاصة 
EnableCaching‏ 


CacheExpirationPolicy 


CacheKeyDependency and sqlCacheDependency 


الوصف 
لتفعيل الخبء في عنصر تحكم مصدر البيانات يجب إسناد القيمة 
مع إلى هذه الخاصة 
تستخدم هذه الخاصة ترم .DataSourceCache Expiry‏ 
Absolute‏ ڍڪ Sliding‏ 


تسمح هذه الخاصة بخبء عناصر مرتبطة بعناصر أخرى ضمن 
کته لات 
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مثال عن الخبء في Sq1Da)a4S0u ce‏ 


عند تفعيل الخبء في عنصر تحكم ١٥٥إ‏ $4150 تتم عملية خبء لنتائج 00111١21‏ )ءء1ءS.‏ 

عند استخدام المعاملات (كإءاهدطهإه۴) في إنشاء استعلام يتم خبء نتائج منفصلة لكل مجموعة من قيم المعاملات. 

مثلاً لنفرض أننا نريد إنشاء صفحة تسمح باستعراض معلومات الموظفين بحسب المدينةء حيث يتم اختيار المدينة من قائمة منسدلة. 
يتم استخدام عنصر التحكم u ۲٥١‏ 54124150 لملء سجلات الموظفین ضمن عنصر تحکم ۷1ew‏ 6114 کما ھو موضح بالشکل: 


Untitled Page - Microsoft Internet Explorer E EK 
Eis. Edt Yiew Favorites. Tools Help O Back - D5 ا‎ 


#[ htkarflaca hak: 1 7EZlZhapter2SqlCataSourcêePar amaktars, zep 


_andor یھ‎ 


EmployeeID FirstName LastName Titla City 
Szawen Buchanan Salas Manager Landon 
Michael SuUYEMma Sales Representatise London 
FEobert Fins] Sales Representatiye Lonrclon 


Anne Dadsworth Sales Eeprasentatiye London 


9 Lazal irtraneE 


نستخدم في هذا المثال عنصري تحكم مصدر قواعد بيانات يقوم أحدها بالاستعلام عن المدن و قيمه لا تتغير بتواتر كبير. 
أما الآخر وهو عنصر تحكم ۷1W‏ 11ا6 فيقوم بإظهار قائمة بالموظفين ومعلوماتهم: 


<asp:SqlDataSource ID="sourceEmployeeCities" runat="server" 
ProviderName="System.Data.SqIClient" 

EnableCaching="True" CacheDuration="3600" 
ConnectionString="<%$ ConnectionStrings:Northwind %>" 
SelectCommand="SELECT DISTINCT City FROM Employees"> 
</asp:SqlDataSource> 

<asp:DropDownList ID="lIstCities" runat="server" 
DataSourcelD="sourceEmployeeCities" 

Data TextField="City" AutoPostBack="True"> 
<l/asp:DropDownList> 


<asp:SqlDataSource ID="sourceEmployees" runat="server" 
ProviderName="System.Data.SqIClient" 

EnableCaching="True"" CacheDuration="600" 

ConnectionString="<%$ ConnectionStrings:Northwind %>" 
SelectCommand="SELECT EmployeelD, FirstName, LastName, Title, City 
FROM Employees WHERE City=@City"> 

<SelectParameters> 

<asp:ControlParameter ControllD="IstCities" Name="City" 
PropertyName="SelectedValue" /> 
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الخبء مع وجود موارد مرتبطة: 


قد يتغير محتوى مصدر البيانات مع مرور الزمن» وقد يتم استعمال نسخة قديمة من المعلومات دون معرفة. 
تدعم ۸8۶.٤1‏ ما يسمى الخبء المرتبط. يمكن هذا النمط من الخبء من ربط عنصر ضمن ذاكرة الخبء مع أحد الموارد بحيث 
يتم إزالة النسخة المخبأة واعتبارها منتهية الصلاحية عند أي تغيير على هذا المورد. 
توفر ۸8۴.٤1‏ ثلاثة أنواع من الخبء المرتبط: 
1- الربط مع عنصر آخر ضمن ذاكرة الخبء 
2- الربط مع ملف أو مجلد 
3- الربط مع استعلام من قاعدة البيانات 


الارتباط بالملفات 
لاستخدام الخبء المرتبط نستعمJ‏ llغرض .CacheDependency‏ 


على سبيل المثال يقوم الرماز التالي بإنشاء ارتباط مع ملف .ProductList.xm1 مسlڊ XML‏ 
سيتم إنهاء صلاحية العنصر المرتبط المخزن في ذاكرة الخبء وإخلائه من الذاكرة عند حصول أي تغير في الملف السابق: 


الخبء المرتبط بعنصر آخر ضمن ذاكرة الخبء 


يوفر الغرض 1ء ١٥م‏ 2ءطءهC‏ مشيد يقبل مصفوفة من أسماء الملفات ومصفوفة من مفاتيح الخبء. 
يمكن باستخدام مصفوفة مفاتيح الخبء إنشاء ارتباط بين عنصر ضمن ذاكرة الخبء وعنصر آخر مخزن ضمن هذه الذاكرة. 
فيما يلي مثال يقوم بربط عنصر ضمن ذاكرة الخبء مع عنصر آخر دون الربط مع ملف: 
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ملاحظة: قمنا باستخدام القيمة 11اه لمعامل مصفوفة الملفات المرتبطة ضمن مشيد .CacheDepe^dency¥‏ 


الخبء المرتبط بقاعدة بيانات 2008 SQL Server 2005 and‏ 


توفر قاعدة بيانات ۲ء5۲۷ 5Q1‏ إمكانية تسجيل استعلام ما لتتم مراقبته من قبل ۲۷۲ء5015 بحيث يتم إرسال رسالة إعلام إلى 
إجرائية ۸5۴.٤1‏ العاملة لإبلاغها بحصول تغيير . 
يقوم [5۲۷۴١‏ باعتبار غرض البيانات لديك منتهي الصلاحية عند حصول تغيير على صف من الصفوف التي يعيدها 
الاستعلام المسجل. 
يتم إرسال رسالة الإعلام بالتغيير لأول مرة يحصل فيها التغيير و ليس مع كل تغيير لاحق حيث تعتبر هذه الطريقة أكثر 
ذكاء حيث تتجنب إرسال رسائل سيتم إهمالها لاحقاً بعد الأخذ بأول رسالة. 
لا حاجة إلى إعدادات خاصة لتفعيل الإعلام في 2008, 2005 إه۷إمء 8Q1‏ (كما هي الحال في نسخ سابقة) لكن يكفي 
استخدام الطريقة المشتركة 7.5141۲0٥”ءل١ءمء‏ 5410 ضمن الرماز. 
يوضح الشكل التالي الآلية التي تعمل فيها رسائل الإعلام في 2008 ,2005 SQL Server‏ 
Your‏ 


ASP.NET 
Page 


قوم النصن البرمبي بتديل البدول 


1 „. ASP.HET pقت‎ „service pai 


ل ٣‏ بانتظار الوسائل ' - 
| بتسجيل التحدياات 4 Worker‏ 
ر | | Process Notificat iin‏ 


الجداول التئن تتم مراتبتها Queue‏ 


تعمل رسائل الإعلام مع استعلامات S1٤٣1‏ ومع الإجرائيات المخزنة. 
لضمان دعم استعلامات 1 S۴18٣‏ لابد من مراعاة القواعد التالية: 


لا بد من استخدام الاسم الكامل للجداول بالصيغة ٥1طه٤.[6۲.س0]‏ أي استخدام الاسم dbo. Employees‏ عوضا عن استخدام 
Employees‏ فقط. 

لا يمكن للاستعلامات أن تتضمن توابع تجnيعuة‏ مڻJ MINO «MAX(0 «CO⁄OUNT(0‏ ي AVERAGEO‏ 

لا يمكن استخدام إشارة * ضمن الاستعلام لتحديد جميع الأعمدة بل يجب ذكر أسمائها بشكل صريح. أي أن الصيغة صه؟ * †م1مS‏ 
ماطها غير قانونية. 
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تفعيل سمسار الخدمات 


لا يتم تفعيل سمسار الخدمات في 5$Q1 86۷١۲2005-2008‏ عند تثبيته لذلك يجب تفعيله بشكل صريح لكل قاعدة بيانات. 
نقوم أولا بتشغيل موجه الأرامر من 0نلں؟ ua1ء¡۷:‏ 


Programs >Microsoft Visual Studio 2008 >Visual Studio Tools >Visual Studio 2008 Command 
Prompt 


بعدها نقوم بتشغيل الأمر #×ع. $41٤٣‏ مع استخدام المعامل 8- و اسم المخدم 


المرحلة التالية هي تفعيل سمسار الخدمات على قاعدة البيانات المراد التعامل معها وذلك عبر استخدام #×ة.ل $41٥٥‏ لتشغيل هذه 
العبارة: 


تأهيل خدمة الخبء 


كما ذكرنا سابقاً لا بد من تأهيل خدمة الخبء باستخدام الطريقة (81۲۲0. ٥٣٥ل‏ ٠م5410‏ قبل الشروع باستخدامها. 
بقوم الرماز التالي مثلاً بتفعيل خدمة التتصت على مخدم الوب لاستلام رسائل الإعلام بالتغيرات: 


لا حاجة لإجراء هذه العملية أكثر من مرة ضمن كامل فترة حياة التطبيق» لذلك فمن المنطقي وضع هذه الطريقة ضمن مقبض حدث 
بدء عمل التطبيق 5)4۲۲0_١10اةء1امم۸‏ في الملف ×هوه.1امط1اGo.‏ 


إنشاء خبء الربط 


لا بد لإنشاء غرض مرتبط باستعلام من تحديد الأمر الذي سيستخدم لاستعادة البيانات ليتمكن المخدم من تحديد الصفوف التي ستتم 
مراقبتها. 

نقوم لهذا الغرض بإنشاء غرض رء١ءل١ءمء2ء1ءa٣‏ $41 الذي يقبل معامل يحدد الاستعلام المطلوب من النمط .S41 ٣0١٣214‏ 
يوضح المثال التالي كيفية تطبيق هذه الخطوات: 
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سيؤدي أي تعديل على صفوف الجدول ١٥ره‏ ام8 إلى إرسال إعلام من قبل قاعدة البيانات. 

يتم استقبال هذا الإعلام من إجرائية ۸8۶.٤1‏ العاملة وإنهاء صلاحية غرض 044861 و حذفه من ذاكرة الخبء. 

لا بد في المرة التالية »التي تتم فيها إعادة إنشاء هذا الغرض بالوضع الجديد بعد التعديلء من إعادة إضافة الغرض من جديد إلى ذاكرة 
الخبء باستخدام غرض e1٥‏ ۸ءمe(ءhطacے٣841‏ جدید. 
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